Skip to main content
POST
/
identities
Create Identity
curl --request POST \
  --url http://localhost:5001/identities \
  --header 'Content-Type: application/json' \
  --header 'X-blnk-key: <api-key>' \
  --data '
{
  "identity_type": "organization",
  "name": "Blnk",
  "category": "fintech",
  "street": "10 Aso Villa Way",
  "country": "Nigeria",
  "state": "Lagos",
  "post_code": "101001",
  "city": "Lagos",
  "created_at": "2023-10-16T10:00:00Z",
  "meta_data": {
    "verified": true,
    "reference": "XYZ123456789"
  }
}
'
{
  "identity_id": "idt_0b5f333d-e0b8-4422-8e0e-5d41a767f1db",
  "identity_type": "organization",
  "organization_name": "",
  "category": "fintech",
  "first_name": "",
  "last_name": "",
  "other_names": "",
  "gender": "",
  "dob": "0001-01-01T00:00:00Z",
  "email_address": "",
  "phone_number": "",
  "nationality": "",
  "street": "10 Aso Villa Way",
  "country": "Nigeria",
  "state": "Lagos",
  "post_code": "101001",
  "city": "Lagos",
  "created_at": "2024-02-20T05:27:44.748526423Z",
  "meta_data": {
    "reference": "XYZ123456789",
    "verified": true
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.blnkfinance.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-blnk-key
string
header
required

Body

application/json
​
identity_type
string
required
​
name
string
required
​
category
string
required
​
street
string
required
​
country
string
required
​
state
string
required
​
post_code
string
required
​
city
string
required
​
created_at
string
required
​
meta_data
MetaData2 · object
required
Example:
{
  "verified": true,
  "reference": "XYZ123456789"
}

Response

201 - application/json; charset=utf-8

Created

​
identity_id
string
required
​
identity_type
string
required
​
organization_name
string
required
​
category
string
required
​
first_name
string
required
​
last_name
string
required
​
other_names
string
required
​
gender
string
required
​
dob
string
required
​
email_address
string
required
​
phone_number
string
required
​
nationality
string
required
​
street
string
required
​
country
string
required
​
state
string
required
​
post_code
string
required
​
city
string
required
​
created_at
string
required
​
meta_data
MetaData2 · object
required
Example:
{
  "verified": true,
  "reference": "XYZ123456789"
}