Skip to main content
GET
/
customers
/
{id}
Customer details
curl --request GET \
  --url https://api.cartevo.co/api/v1/customers/{id} \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "statusCode": 200,
  "message": "Data retrieved successfully",
  "data": {
    "id": "4d4dad81-7899-4612-a9f6-133ce56a4507",
    "email": "customer@example.com",
    "first_name": "John",
    "last_name": "Doe",
    "is_active": true,
    "country": "Cameroon",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}

​
Overview

GET /customers/{id} returns full details of a single customer in your company.

​
When to use it

  • Display a customer profile in your dashboard.
  • Check a customer’s status before issuing them a card.
  • Reconcile a single customer record.

​
Prerequisites

  • The customer must belong to your company.

​
Request

​
Headers

NameRequiredDescription
AuthorizationYesBearer <access_token>

​
Path parameters

NameTypeDescription
idstringCustomer ID (UUID).

​
Response

​
200 — Success

{
  "success": true,
  "statusCode": 200,
  "message": "Data retrieved successfully",
  "data": {
    "id": "8d4f2a1b-5c3e-4d7f-9a6b-2e1c8f9d0a3b",
    "first_name": "John",
    "last_name": "Doe",
    "email": "john.doe@example.com",
    "country": "Cameroon",
    "street": "123 Main Street",
    "city": "Yaoundé",
    "state": "Centre",
    "postal_code": "00237",
    "phone_country_code": "+237",
    "phone_number": "600000000",
    "identification_number": "12345678901",
    "type": "NIN",
    "number": "12345678901",
    "image": "https://cdn.cartevo.co/kyc/.../front.jpg",
    "photo": "https://cdn.cartevo.co/kyc/.../back.jpg",
    "date_of_birth": "1990-01-15T00:00:00.000Z",
    "is_active": true,
    "created_at": "2026-05-09T10:15:00.000Z",
    "updated_at": "2026-05-09T10:15:00.000Z"
  }
}

​
Field reference

FieldTypeDescription
idstringCustomer ID (UUID).
first_name, last_namestringAs submitted at creation.
emailstringCustomer’s email address. Unique within your company.
countrystringFull country name as submitted.
street, city, state, postal_codestringPostal address.
phone_country_codestringDial code with + (e.g. +237).
phone_numberstringLocal subscriber number.
typestringThe id_document_type submitted (NIN, PASSPORT, VOTERS_CARD, DRIVERS_LICENSE).
numberstringThe identification_number submitted.
imagestringURL to the front of the ID document. Cartevo-hosted if you uploaded files; your own URL if you used /customers/enroll.
photostringURL to the back of the ID document, when applicable.
date_of_birthstringISO 8601.
is_activebooleantrue for active customers; false if disabled by Cartevo.
created_at / updated_atstringISO 8601 timestamps.

​
Error responses

StatusTrigger
404Customer does not exist or belongs to another company.

​
Code examples

cURL
curl https://api.cartevo.co/api/v1/customers/8d4f2a1b-5c3e-4d7f-9a6b-2e1c8f9d0a3b \
  -H "Authorization: Bearer $TOKEN"
Node.js (axios)
const { data } = await axios.get(
  `https://api.cartevo.co/api/v1/customers/${customerId}`,
  { headers: { Authorization: `Bearer ${token}` } }
);

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string<uuid>
required

Response

Detailed information for a single customer.

​
success
boolean
Example:

true

​
statusCode
integer
Example:

200

​
message
string
Example:

"Data retrieved successfully"

​
data
object