Skip to main content
POST
/
api
/
external
/
customer
curl --request POST \
  --url https://api-prod.blaaiz.com/api/external/customer \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "individual",
  "first_name": "John",
  "last_name": "Doe",
  "email": "john.doe@company.com",
  "country": "NG",
  "id_type": "passport",
  "id_number": "6733823632872",
  "phone": "+2348012345678",
  "dob": "1990-01-15",
  "street": "123 Main Street",
  "city": "Lagos",
  "state": "Lagos",
  "zip_code": "100001",
  "id_expiry_date": "2030-01-15",
  "id_issue_date": "2020-01-15"
}
'
{
  "message": "Customer created successfully.",
  "data": {
    "id": "9d4c4ec5-59ea-4130-bf8a-6a5edec401ee",
    "business_id": "9d4c4ec5-572d-49de-a362-f01ed09f2b1b",
    "first_name": "John",
    "last_name": "Doe",
    "business_name": null,
    "type": "individual",
    "email": "john.doe@company.com",
    "country": "NG",
    "id_type": "passport",
    "id_number": "6733823632872",
    "verification_status": "PENDING"
  }
}

Documentation Index

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

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

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
type
enum<string>
required

Customer type.

Available options:
individual,
business
​
email
string<email>
required
​
country
string
required

Country code (e.g., NG, CA, US). This must match the country on the identity document submitted for KYC.

​
id_type
enum<string>
required

Identity document type. For individual customers, drivers_license (Driver's License), passport (Passport), or resident_permit (Resident Permit) are accepted. For business customers, only certificate_of_incorporation (Certificate of Incorporation) is accepted. ID cards (National Identity Cards) are not accepted. No other document types are supported.

Available options:
drivers_license,
passport,
resident_permit,
certificate_of_incorporation
​
id_number
string
required
​
first_name
string

Required if type is individual.

​
last_name
string

Required if type is individual.

​
business_name
string

Required if type is business.

​
phone
string
​
tin
string

Tax identification number (varies by country). Where applicable, use the Get Identification Type endpoint to determine the correct label or field to collect for the customer's country and type.

​
dob
string<date>
​
street
string
​
city
string
​
state
string
​
zip_code
string
​
id_expiry_date
string<date>
​
id_issue_date
string<date>

Response

Customer created successfully.

​
message
string
required
​
data
object
required