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

# Get a Customer

> Retorna um cliente pelo ID.

Retorna um `customer` pelo ID. Para correlacionar com um ID do seu sistema,
armazene o `cus_*` ao criar o cliente (ou guarde sua chave em
`metadata.reference_id` e busque por email via
[`GET /v1/customers`](/api-reference/customers/list)).

## Autenticação

A API key da própria organização atua diretamente. A API key de plataforma exige o
header `Organization: <organization_id>` apontando para uma organização
conectada ativa.

## Parâmetros de caminho

<ParamField path="id" type="string" required>
  ID do cliente (`cus_*`).
</ParamField>

<RequestExample>
  ```bash cURL theme={}
  curl -X GET "https://api.chargefy.io/v1/customers/cus_123" \
    -H "Authorization: Bearer {{API_KEY}}"
  ```
</RequestExample>

## Resposta

`200 OK` com o objeto `customer` completo. Mesmo shape de
[`POST /v1/customers`](/api-reference/customers/create#resposta).

<ResponseExample>
  ```json 200 theme={}
  {
    "id": "cus_123",
    "object": "customer",
    "billing_address": {
      "city": "São Paulo",
      "country": "BR",
      "line1": "Av. Paulista, 1000",
      "line2": null,
      "postal_code": "01310-100",
      "state": "SP"
    },
    "billing_name": null,
    "created_at": "2026-05-16T14:09:27Z",
    "document": "12345678901",
    "document_type": "cpf",
    "email": "nome@email.com",
    "livemode": true,
    "metadata": {
      "reference_id": "ref_456"
    },
    "name": "Cliente Exemplo",
    "phone": "+5511999990000",
    "updated_at": "2026-05-16T15:02:10Z"
  }
  ```
</ResponseExample>

## Erros comuns

| Status | `code`             | Quando ocorre                                          |
| ------ | ------------------ | ------------------------------------------------------ |
| `404`  | `resource_missing` | Cliente não existe nesta organização (ou foi removido) |