SupportDashboard
HomeGet StartedPaymentsCryptoComplianceChangelog

Update a customer

Update customer profile details. Non-verified customers can update all fields. Verified customers can only update fields that are currently null — if you need to correct a mistake on a verified customer (wrong document, misspelled name, incorrect details), you must request a manual correction from the Blaaiz operations team by emailing support@blaaiz.com. See the Customer data corrections guide for the full process. The customer's country must match the country on the identity document submitted for KYC. Accepted identity documents: Driver's License, Passport, or Resident Permit for individual customers, Certificate of Incorporation for business customers. ID cards (National Identity Cards) are not accepted. All uploaded documents must be clear, legible, and authentic — unclear images will be rejected. Fraudulent or falsified documents will result in the customer being permanently blacklisted from the platform. Required scope: customer:write.

PUTapi-prod.blaaiz.com/api/external/customer/{id}

Authorization

oauth2ClientCredentials customer:write
AuthorizationBearer <token>

Use your OAuth client credentials to obtain a short-lived Bearer token from POST /oauth/token.

In: header

Scope: customer:write

Path Parameters

id*string

Customer ID

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

kyb_scope is read-only here. It cannot be modified through this endpoint — sending it returns 422. To upgrade a MINIMAL customer to FULL, use POST /customer/{id}/upgrade-kyb-scope. There is no downgrade path.

Response Body

application/json

application/json

application/json

application/json

application/json

Update a customer
curl --request PUT \  --url 'https://example.com/api/external/customer/string' \  --header 'Content-Type: application/json' \  --data '{  "first_name": "Oluwatobi",  "last_name": "Ishola",  "business_name": "Blaaiz",  "email": "oluwatobi.ishola+customer@blaaiz.com",  "phone": "+2348012345678",  "country": "NG",  "id_type": "passport",  "id_number": "A123456789",  "tin": "12345-ABCDE",  "dob": "1996-08-21",  "street": "12 Admiralty Way",  "city": "Lagos",  "state": "Lagos",  "zip_code": "101233",  "id_expiry_date": "2030-12-31",  "id_issue_date": "2020-01-15"}'
{  "message": "Customer updated successfully",  "data": {    "id": "9d4c4ec5-59ea-4130-bf8a-6a5edec401ee",    "business_id": "9d4c4ec5-572d-49de-a362-f01ed09f2b1b",    "type": "individual",    "first_name": "John",    "last_name": "Doe",    "business_name": null,    "email": "john.doe@example.com",    "phone": "+2348098765432",    "country": "NG",    "id_type": "passport",    "id_number": "A12345678",    "registration_number": null,    "incorporation_country": null,    "verification_status": "VERIFIED",    "created_at": "2024-01-15T10:30:00.000000Z",    "updated_at": "2024-01-15T11:00:00.000000Z"  }}

GETGet a customer

Retrieve customer details by ID. Required scope: `customer:read`.

POSTAdd KYC details

Add KYC details for a customer. Verification stays PENDING until documents are uploaded and reviewed. The customer's country must match the country on the identity document submitted for KYC. Accepted identity documents: Driver's License, Passport, or Resident Permit for individual customers, Certificate of Incorporation for business customers. ID cards (National Identity Cards) are not accepted. All uploaded documents must be clear, legible, and authentic — unclear images will be rejected. Fraudulent or falsified documents will result in the customer being permanently blacklisted from the platform. Required scope: `customer:write`.