> ## Documentation Index
> Fetch the complete documentation index at: https://docs.v2.certopaybrasil.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve a Customer by UUID — GET /api/customers

> GET /api/customers/{id} — Fetch a single customer by their UUID. Returns the full customer record including name, email, document, and phone.

Use this endpoint to fetch the full record of a single customer by their UUID. This is useful when you need to verify a customer's details before processing an order, display buyer information in your dashboard, or confirm that a registration was saved correctly. Pass the customer UUID in the URL path where `{id}` appears.

## Request

<ParamField header="X-Api-Key" type="string" required>
  Your CertoPay secret API key. Include it in every request as `X-Api-Key: sk_live_sua_chave_aqui`.
</ParamField>

<ParamField path="id" type="string" required>
  The UUID of the customer to retrieve. This is the `id` returned when the customer was created via `POST /api/customers`.
</ParamField>

This endpoint accepts no request body.

## Response

A successful request returns **HTTP 200 OK** with the full customer object.

<ResponseField name="id" type="string">
  Unique UUID identifying the customer.
</ResponseField>

<ResponseField name="name" type="string">
  Full name of the customer.
</ResponseField>

<ResponseField name="email" type="string">
  Email address of the customer.
</ResponseField>

<ResponseField name="document" type="string">
  CPF number (11 digits) of the customer.
</ResponseField>

<ResponseField name="phone" type="string">
  Phone number of the customer.
</ResponseField>

<ResponseField name="createdAt" type="string">
  ISO 8601 timestamp of when the customer record was created.
</ResponseField>

## Example

```bash theme={null}
curl https://v2.certopaybrasil.com/api/customers/uuid-do-customer \
  -H "X-Api-Key: sk_live_sua_chave_aqui"
```

```json 200 OK theme={null}
{
  "id": "uuid-do-customer",
  "name": "João da Silva",
  "email": "joao@email.com",
  "document": "12345678900",
  "phone": "(11) 99999-9999",
  "createdAt": "2026-06-26T10:00:00Z"
}
```