Skip to main content
GET
Get customer
The authenticated API key can only access customers that belong to its merchant.

Authorizations

X-Api-Key
string
header
required

Public API key from the merchant dashboard.

X-Api-Secret
string
header
required

Secret shown once when the API key is created.

Path Parameters

customer_id
string<uuid>
required

Response

Customer object.

customer_type
enum<string>
default:individual
required
Available options:
individual,
retail,
business
id
string<uuid>
required
merchant_id
string<uuid>
required
kyc_status
enum<string>
required
Available options:
not_started,
pending,
approved,
rejected
status
string
required
Example:

"active"

created_at
string<date-time>
required
updated_at
string<date-time>
required
external_ref
string

Merchant reference, unique per merchant.

first_name
string
last_name
string
business_name
string
id_number
string
id_type
enum<string>
Available options:
national_id,
passport,
driver_license
email
string<email>
phone
string
Example:

"+237670000000"

country_code
string
Required string length: 2
Example:

"CM"

nationality_code
string
Required string length: 2
Example:

"CM"

date_of_birth
string<date>
address_line1
string
city
string
occupation
string
source_of_funds
string
_meta
object
Last modified on July 8, 2026