Skip to main content
POST
/
api
/
external
/
customer
curl --request POST \
  --url https://api-prod.blaaiz.com/api/external/customer \
  --header 'Content-Type: application/json' \
  --header 'x-blaaiz-api-key: <api-key>' \
  --data '
{
  "type": "individual",
  "first_name": "John",
  "last_name": "Doe",
  "email": "[email protected]",
  "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": "[email protected]",
    "country": "NG",
    "id_type": "passport",
    "id_number": "6733823632872",
    "verification_status": "PENDING"
  }
}

Authorizations

​
x-blaaiz-api-key
string
header
required

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).

​
id_type
enum<string>
required

ID type; certificate_of_incorporation only valid for business.

Available options:
drivers_license,
passport,
id_card,
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).

​
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