> ## Documentation Index
> Fetch the complete documentation index at: https://developer.cartevo.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Customer by ID

> Retrieve full details of a single customer, including KYC document references and address.

## 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

| Name            | Required | Description             |
| --------------- | -------- | ----------------------- |
| `Authorization` | Yes      | `Bearer <access_token>` |

### Path parameters

| Name | Type   | Description         |
| ---- | ------ | ------------------- |
| `id` | string | Customer ID (UUID). |

## Response

### 200 — Success

```json theme={null}
{
  "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

| Field                                    | Type    | Description                                                                                                              |
| ---------------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------ |
| `id`                                     | string  | Customer ID (UUID).                                                                                                      |
| `first_name`, `last_name`                | string  | As submitted at creation.                                                                                                |
| `email`                                  | string  | Customer's email address. Unique within your company.                                                                    |
| `country`                                | string  | Full country name as submitted.                                                                                          |
| `street`, `city`, `state`, `postal_code` | string  | Postal address.                                                                                                          |
| `phone_country_code`                     | string  | Dial code with `+` (e.g. `+237`).                                                                                        |
| `phone_number`                           | string  | Local subscriber number.                                                                                                 |
| `type`                                   | string  | The `id_document_type` submitted (`NIN`, `PASSPORT`, `VOTERS_CARD`, `DRIVERS_LICENSE`).                                  |
| `number`                                 | string  | The `identification_number` submitted.                                                                                   |
| `image`                                  | string  | URL to the front of the ID document. Cartevo-hosted if you uploaded files; your own URL if you used `/customers/enroll`. |
| `photo`                                  | string  | URL to the back of the ID document, when applicable.                                                                     |
| `date_of_birth`                          | string  | ISO 8601.                                                                                                                |
| `is_active`                              | boolean | `true` for active customers; `false` if disabled by Cartevo.                                                             |
| `created_at` / `updated_at`              | string  | ISO 8601 timestamps.                                                                                                     |

### Error responses

| Status | Trigger                                                |
| ------ | ------------------------------------------------------ |
| `404`  | Customer does not exist or belongs to another company. |

## Code examples

```bash cURL theme={null}
curl https://api.cartevo.co/api/v1/customers/8d4f2a1b-5c3e-4d7f-9a6b-2e1c8f9d0a3b \
  -H "Authorization: Bearer $TOKEN"
```

```js Node.js (axios) theme={null}
const { data } = await axios.get(
  `https://api.cartevo.co/api/v1/customers/${customerId}`,
  { headers: { Authorization: `Bearer ${token}` } }
);
```

## Related

* [`GET /customers`](/api-reference/endpoint/get-customers) — list all customers.
* [`GET /customers/{id}/transactions`](/api-reference/endpoint/get-customer-transactions) — this customer's transaction history.
* [`POST /cards`](/api-reference/endpoint/post-create-card) — issue a card to this customer.


## OpenAPI

````yaml GET /customers/{id}
openapi: 3.1.0
info:
  title: Cartevo API
  description: Essential endpoints for wallets, transactions, customers and conversion.
  version: 1.0.0
servers:
  - url: https://api.cartevo.co/api/v1
security:
  - bearerAuth: []
paths:
  /customers/{id}:
    get:
      summary: Customer details
      description: Retrieves the details of a single customer by their ID.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Detailed information for a single customer.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetCustomerResponse'
        '404':
          description: Customer not found.
components:
  schemas:
    GetCustomerResponse:
      allOf:
        - $ref: '#/components/schemas/StandardResponse'
        - type: object
          properties:
            data:
              $ref: '#/components/schemas/CustomerDetails'
    StandardResponse:
      type: object
      properties:
        success:
          type: boolean
          example: true
        statusCode:
          type: integer
          example: 200
        message:
          type: string
          example: Data retrieved successfully
    CustomerDetails:
      type: object
      properties:
        id:
          type: string
          format: uuid
          example: 4d4dad81-7899-4612-a9f6-133ce56a4507
        email:
          type: string
          format: email
          example: customer@example.com
        first_name:
          type: string
          example: John
        last_name:
          type: string
          example: Doe
        is_active:
          type: boolean
          example: true
        country:
          type: string
          example: Cameroon
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````