---
title: "Retrieve a customer by ID"
method: GET
path: "/api/v1/admin/customers/{customerId}"
tags: ["Customers", "Admin"]
---

# Retrieve a customer by ID

`GET /api/v1/admin/customers/{customerId}`

Retrieve a customer by ID

## Path parameters

- `customerId` string, uuid, required — The unique identifier of the customer

## Response `200`

Success

- CustomerResponse
  - `success` boolean, required — Indicates if the request was successful
  - `data` union, required — Customer information
    - object
      - `id` string, uuid — Customer's unique identifier
      - `name` string — Customer's full name
      - `email` string, email, required — Customer's email address
      - `phone_number` string — Customer's phone number in E.164 format
      - `created_at` string, date-time — Timestamp when the customer was created
      - `updated_at` string, date-time — Timestamp when the customer was last updated
    - object
      - `id` string, uuid — Customer's unique identifier
      - `name` string — Customer's full name
      - `email` string, email — Customer's email address
      - `phone_number` string, required — Customer's phone number in E.164 format
      - `created_at` string, date-time — Timestamp when the customer was created
      - `updated_at` string, date-time — Timestamp when the customer was last updated

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

## Changes

- **2026-06-16** `b372e7d5563d` — 1 breaking, 1 warning, 2 info
  - the `error/code` response's property type/format changed from `string`/`` to ``/`` for status `400`
  - removed the optional property `error/errors` from the response with the `400` status
  - added the optional property `error/metadata` to the response with the `400` status
  - added `subschema #1, subschema #2` to the `error/code` response property `allOf` list for the response status `400`
- **2025-11-03** `6637b341d86d` — 1 info
  - endpoint added
- **2025-11-02** `919eb7a392aa` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/banqzinc/apis/quidkey-api/changes/api/v1/admin/customers/:customerId/get.md)

---

[API](https://skmtc.dev/banqzinc/apis/quidkey-api.md) · [All operations](https://skmtc.dev/banqzinc/apis/quidkey-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/banqzinc/quidkey-api/revisions/f86d2bdbcb08/schema)