---
title: "Get Customer"
method: GET
path: "/customers/{id}"
---

# Get Customer

`GET /customers/{id}`

Fetches a specific customer object. Provide the customer `_id` and the corresponding object will be returned.

## Path parameters

- `id` string, required

## Response `200`

Customer fetched successfully.

- object
  - `statusCode` integer — Status code of the response. `200` indicates a successful request.
  - `message` string — Human-readable description of the result.
  - `data` object — Response payload.
    - `_id` string — Unique identifier of the object.
    - `business` string — Identifier of the business that owns this object.
    - `type` string — Type of the object.
    - `name` string — Display name.
    - `status` string — Current status of the object.
    - `isApproved` boolean — Whether the customer has passed KYC and is approved.
    - `phoneNumber` string — Customer's phone number in international format.
    - `emailAddress` string — Customer's email address.
    - `individual` object — Details for an individual customer.
      - `firstName` string — First name.
      - `lastName` string — Last name.
      - `otherNames` string — Other names, if any.
      - `dob` string — Date of birth (YYYY/MM/DD).
      - `identity` object — Customer's verified identity record.
        - `type` string — Type of the object.
        - `number` string — Identity / card number value.
      - `documents` object — Uploaded KYC document URLs.
        - `idFrontUrl` string — URL of the front of the customer's ID document.
        - `idBackUrl` string — URL of the back of the customer's ID document.
        - `addressVerificationUrl` string — URL of the customer's address verification document.
    - `billingAddress` object — Customer's billing address.
      - `line1` string — Address line 1.
      - `line2` string — Address line 2.
      - `city` string — City.
      - `state` string — State / region.
      - `postalCode` string — Postal / ZIP code.
      - `country` string — Country.
    - `createdAt` string, date-time — ISO 8601 timestamp of when the object was created.
    - `updatedAt` string, date-time — ISO 8601 timestamp of when the object was last updated.
    - `__v` integer — Internal document version (Mongo).

## Other responses

- `400` — Validation error — the id is not a valid customer id.
- `401` — Authentication failed — missing or invalid API key.
- `404` — No customer exists with the supplied id.

---

[API](https://skmtc.net/sudo/apis/sudo-sandbox-api.md) · [All operations](https://skmtc.net/sudo/apis/sudo-sandbox-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sudo/sudo-sandbox-api/versions/52be624fcb53/schema)