Skip to main content
GET
https://api.business.bumxpress.com
/
customers
/
{customer_id}
Get customer
curl --request GET \
  --url https://api.business.bumxpress.com/customers/{customer_id} \
  --header 'X-Api-Key: <api-key>' \
  --header 'X-Api-Secret: <api-key>'
{
  "customer_type": "individual",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "merchant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "active",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "external_ref": "<string>",
  "first_name": "<string>",
  "last_name": "<string>",
  "business_name": "<string>",
  "id_number": "<string>",
  "email": "jsmith@example.com",
  "phone": "+237670000000",
  "country_code": "CM",
  "nationality_code": "CM",
  "date_of_birth": "2023-12-25",
  "address_line1": "<string>",
  "city": "<string>",
  "occupation": "<string>",
  "source_of_funds": "<string>",
  "_meta": {
    "idempotency_key": "<string>",
    "idempotency_replayed": true
  }
}
{
"error": {
"code": "bad_request",
"message": "quote_id is required"
}
}
{
"error": {
"code": "bad_request",
"message": "quote_id is required"
}
}
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