Get Customer
GET
/api/v1/customers/{customerId}
business customer the company details are returned in the business object; for an individualcustomer
business is null.data)| Field | Type | Description |
|---|---|---|
id | string (uuid) | Customer identifier |
type | string | individual or business |
firstName / middleName / lastName | string, nullable | Individual name parts |
businessName | string, nullable | Business name held on the customer record |
email | string | Email address |
phoneCode / phoneNumber | string | Phone |
country | string | Country name |
status | string | Record status - Active, Inactive, Disable, Rejected, Submitted |
dateOfBirth | string (date), nullable | YYYY-MM-DD |
gender | string, nullable | Gender |
externalReference | string, nullable | Your reference |
business | object, nullable | businessName, registrationNumber, taxId, incorporationDate, website, industry, companyType, description |
createdAt / updatedAt | string (date-time) | Timestamps (UTC) |
status is the record state. For KYC progress use Get Customer Product Status.Request
Path Params
Header Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/api/v1/customers/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
--header 'X-API-Key;' \
--header 'X-Signature;' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Body-Hash;' \
--header 'X-Idempotency-Key;'Response Response Example
200 - Individual customer
{
"data": {
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"type": "individual",
"firstName": "Jane",
"middleName": null,
"lastName": "Doe",
"businessName": null,
"email": "jane.doe@example.com",
"phoneCode": "+44",
"phoneNumber": "7700900000",
"country": "United Kingdom",
"status": "Active",
"dateOfBirth": "1990-06-15",
"gender": "female",
"externalReference": "usr_12345",
"business": null,
"createdAt": "2026-01-15T10:30:00Z",
"updatedAt": "2026-01-15T10:30:00Z"
},
"requestId": "9f2c4b6e8a1d4f0cb7e35a91d2c46f80",
"timestamp": "2026-08-22T10:30:00.123Z"
}Modified at 2026-08-22 04:49:45