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. To correct a saved field on a verified business customer, submit a change request from the Blaaiz Business Dashboard. This process does not change customer documents or files. See the Customer data corrections guide. 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`.