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

# Buscar Cliente

Este endpoint permite recuperar as informações de um cliente específico usando seu ID único ou email.

## Casos de Uso

* **Consulta de dados** do cliente para exibição
* **Validação** antes de processar pagamentos
* **Recuperação de informações** para formulários
* **Sincronização** de dados entre sistemas

## Parâmetros de URL

<ParamField path="identifier" type="string" required>
  Identificador do cliente. Pode ser UUID, email ou hash do cliente

  * **UUID do cliente** (ex: `142465c6-4c9d-4fd1-9632-2c40af316da3`)
  * **Email do cliente** (ex: `maria@exemplo.com.br`)
  * **Hash do cliente** (ex: `AUTCUS01K8RSCH3T5FNB7EVACV8DQVNX`)
</ParamField>

## Exemplos de Requisição

### Buscar por UUID

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET https://pay.autorizou.dev/api/v1/customers/142465c6-4c9d-4fd1-9632-2c40af316da3 \
    -H "Authorization: Bearer 4eC39HqLyjWDarjtT1zdp7dc"
  ```

  ```javascript JavaScript theme={null}
  const customer = await fetch('https://pay.autorizou.dev/api/v1/customers/142465c6-4c9d-4fd1-9632-2c40af316da3', {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer 4eC39HqLyjWDarjtT1zdp7dc'
    }
  });

  const result = await customer.json();
  console.log('Cliente encontrado:', result);
  ```

  ```php PHP theme={null}
  <?php

  $customerId = '142465c6-4c9d-4fd1-9632-2c40af316da3';

  $curl = curl_init();
  curl_setopt_array($curl, [
      CURLOPT_URL => "https://pay.autorizou.dev/api/v1/customers/{$customerId}",
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_HTTPHEADER => [
          'Authorization: Bearer 4eC39HqLyjWDarjtT1zdp7dc'
      ]
  ]);

  $response = curl_exec($curl);
  $customer = json_decode($response, true);
  curl_close($curl);

  echo "Cliente: " . json_encode($customer, JSON_PRETTY_PRINT);
  ?>
  ```
</CodeGroup>

### Buscar por Email

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://pay.autorizou.dev/api/v1/customers/maria@exemplo.com.br" \
    -H "Authorization: Bearer 4eC39HqLyjWDarjtT1zdp7dc"
  ```

  ```javascript JavaScript theme={null}
  const email = encodeURIComponent('maria@exemplo.com.br');
  const customer = await fetch(`https://pay.autorizou.dev/api/v1/customers/${email}`, {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer 4eC39HqLyjWDarjtT1zdp7dc'
    }
  });

  const result = await customer.json();
  console.log('Cliente encontrado:', result);
  ```

  ```php PHP theme={null}
  <?php

  $email = urlencode('maria@exemplo.com.br');

  $curl = curl_init();
  curl_setopt_array($curl, [
      CURLOPT_URL => "https://pay.autorizou.dev/api/v1/customers/{$email}",
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_HTTPHEADER => [
          'Authorization: Bearer 4eC39HqLyjWDarjtT1zdp7dc'
      ]
  ]);

  $response = curl_exec($curl);
  $customer = json_decode($response, true);
  curl_close($curl);

  echo "Cliente: " . json_encode($customer, JSON_PRETTY_PRINT);
  ?>
  ```
</CodeGroup>

### Buscar por Hash

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://pay.autorizou.dev/api/v1/customers/AUTCUS01K8RSCH3T5FNB7EVACV8DQVNX" \
    -H "Authorization: Bearer 4eC39HqLyjWDarjtT1zdp7dc"
  ```

  ```javascript JavaScript theme={null}
  const hash = encodeURIComponent('AUTCUS01K8RSCH3T5FNB7EVACV8DQVNX');
  const customer = await fetch(`https://pay.autorizou.dev/api/v1/customers/${hash}`, {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer 4eC39HqLyjWDarjtT1zdp7dc'
    }
  });

  const result = await customer.json();
  console.log('Cliente encontrado:', result);
  ```

  ```php PHP theme={null}
  <?php

  $hash = urlencode('AUTCUS01K8RSCH3T5FNB7EVACV8DQVNX');

  $curl = curl_init();
  curl_setopt_array($curl, [
      CURLOPT_URL => "https://api.autorizou.cloud/v1/customers/{$hash}",
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_HTTPHEADER => [
          'Authorization: Bearer 4eC39HqLyjWDarjtT1zdp7dc'
      ]
  ]);

  $response = curl_exec($curl);
  $customer = json_decode($response, true);
  curl_close($curl);

  echo "Cliente: " . json_encode($customer, JSON_PRETTY_PRINT);
  ?>
  ```
</CodeGroup>

## Resposta de Sucesso

```json theme={null}
{
  "id": "142465c6-4c9d-4fd1-9632-2c40af316da3",
  "hash": "AUTCUS01K8RSCH3T5FNB7EVACV8DQVNX",
  "name": "Maria da Silva Santos",
  "email": "maria.santos@exemplo.com.br",
  "created_at": "29/10/2025 17:08:42",
  "updated_at": "29/10/2025 17:08:42"
}
```

## Códigos de Erro

<AccordionGroup>
  <Accordion title="404 - Not Found" icon="circle-xmark">
    Cliente não encontrado

    ```json theme={null}
    {
       "message": "Cliente não encontrado."
    }
    ```

    **Possíveis causas:**

    * UUID, email ou hash não existe
    * Cliente pertence a outro merchant
    * Identificador malformado
  </Accordion>

  <Accordion title="400 - Bad Request" icon="circle-xmark">
    Parâmetro de identificação inválido

    ```json theme={null}
    {
      "message": "Identificador do cliente é inválido"
    }
    ```
  </Accordion>
</AccordionGroup>

## Detalhes da Resposta

### Campos Principais

| Campo        | Tipo   | Descrição                  |
| ------------ | ------ | -------------------------- |
| `id`         | string | UUID único do cliente      |
| `hash`       | string | Hash do cliente            |
| `name`       | string | Nome completo do cliente   |
| `email`      | string | Email do cliente           |
| `created_at` | string | Data de criação            |
| `updated_at` | string | Data da última atualização |

## Considerações de Performance

<Tip>
  **Cache recomendado:** As informações do cliente mudam raramente. Considere implementar cache local com TTL de 1 hora para melhorar a performance.
</Tip>

<Note>
  **Rate limiting:** Este endpoint está sujeito aos limites de requisições por minuto do seu plano.
</Note>

## Próximos Passos

Após recuperar os dados do cliente:

1. [Processar um pagamento](/api-reference/charges/criar-ordem)
2. [Criar um novo cartão](/api-reference/cards/criar-cartao)