Skip to main content
GET
https://api.cloud.blnkfinance.com
/
data
/
identities
/
{identity_id}
curl -X GET "https://api.cloud.blnkfinance.com/data/identities/idt_3b63c8da-af29-4cc3-ad38-df17d87456e6?instance_id=YOUR_INSTANCE_ID" \
  -H "Authorization: Bearer blnk_at_YOUR_ACCESS_TOKEN"

{
  "identity_id": "idt_3b63c8da-af29-4cc3-ad38-df17d87456e6",
  "first_name": "John",
  "last_name": "Doe",
  "other_names": "",
  "email_address": "[email protected]",
  "phone_number": "+1234567890",
  "nationality": "US",
  "gender": "male",
  "dob": "1990-01-01",
  "street": "123 Main St",
  "city": "New York",
  "state": "NY",
  "post_code": "10001",
  "country": "US",
  "organization_name": "",
  "category": "individual",
  "identity_type": "customer",
  "created_at": "2024-11-26T08:36:36.238244338Z",
  "meta_data": {
    "myApp": {
      "segment": "premium",
      "kyc_status": "verified"
    }
  }
}
Retrieve details for a specific identity by its ID.
For in-depth information about Blnk’s ledger, balance, transaction, and identity APIs, see the Blnk Core docs.

​
Request structure

curl -X GET "https://api.cloud.blnkfinance.com/data/identities/idt_3b63c8da-af29-4cc3-ad38-df17d87456e6?instance_id=YOUR_INSTANCE_ID" \
  -H "Authorization: Bearer blnk_at_YOUR_ACCESS_TOKEN"
​
identity_id
string
required
Unique identifier of the identity to retrieve.
​
Authorization
string
required
Bearer token for authentication. Format: Bearer <access_token>. Your OAuth key must include data:read scope (or *).

​
Query parameters

​
instance_id
string
required
The Blnk Core instance ID to read from. Find this in Blnk Cloud under Instances.

​
Response structure

{
  "identity_id": "idt_3b63c8da-af29-4cc3-ad38-df17d87456e6",
  "first_name": "John",
  "last_name": "Doe",
  "other_names": "",
  "email_address": "[email protected]",
  "phone_number": "+1234567890",
  "nationality": "US",
  "gender": "male",
  "dob": "1990-01-01",
  "street": "123 Main St",
  "city": "New York",
  "state": "NY",
  "post_code": "10001",
  "country": "US",
  "organization_name": "",
  "category": "individual",
  "identity_type": "customer",
  "created_at": "2024-11-26T08:36:36.238244338Z",
  "meta_data": {
    "myApp": {
      "segment": "premium",
      "kyc_status": "verified"
    }
  }
}
​
identity_id
string
required
Unique identifier for the identity.
​
first_name
string
First name of the identity.
​
last_name
string
Last name of the identity.
​
other_names
string
Other names or aliases for the identity.
​
email_address
string
Email address of the identity.
​
phone_number
string
Phone number of the identity.
​
nationality
string
Nationality code of the identity.
​
gender
string
Gender of the identity.
​
dob
string
Date of birth of the identity.
​
street
string
Street address of the identity.
​
city
string
City of the identity.
​
state
string
State or province of the identity.
​
post_code
string
Postal code of the identity.
​
country
string
Country code of the identity.
​
organization_name
string
Organization name, if the identity is an organization.
​
category
string
Category of the identity (e.g., individual, organization).
​
identity_type
string
Type of the identity (e.g., customer, vendor).
​
created_at
timestamp
required
ISO 8601 formatted timestamp of when the identity was created.
​
meta_data
object
Metadata object attached to the identity, if any.
For filters and supported fields, see the Data API docs.

​
Need help?

If you’re having trouble with Blnk Cloud, don’t hesitate to send us a message via email at [email protected] or send us a message here.