> ## Documentation Index
> Fetch the complete documentation index at: https://scaleup-c34c4386.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /api/v1/buyers/lookup/:email

> Busca um comprador pelo e-mail com prioridade: cliente da organização → registro global

Busca um comprador pelo e-mail usando a seguinte ordem de prioridade:

1. **Cliente da organização** (`source: 'customer'`) — requer `organization_id`. Consulta a tabela `customers` da organização.
2. **Registro global do gateway** (`source: 'local'`) — consulta o cadastro local de compradores do gateway.
3. **Não encontrado** (`source: 'none'`) — retorna `found: false`.

## Autenticação

Não requer autenticação.

## Parâmetros de Rota

**email** `string` *required*

E-mail do comprador a ser buscado

## Parâmetros de Query

**organization\_id** `string`

ID da organização. Quando informado, a busca prioriza clientes da organização

## Resposta

**found** `boolean`

`true` se o comprador foi encontrado em alguma fonte

**source** `string`

Fonte onde o comprador foi encontrado: `customer`, `local` ou `none`

**buyer** `object | null`

Dados consolidados do comprador (ou `null` se não encontrado)

**Propriedades**

**taxpayer\_id** `string`

CPF do comprador

**first\_name** `string`

Nome

**last\_name** `string`

Sobrenome

**email** `string`

E-mail

**phone\_number** `string`

Telefone

**birthdate** `string`

Data de nascimento

**zoop\_buyer\_id** `string`

ID do comprador no gateway (se existir)

**local\_data** `object | null`

Dados brutos do registro local (comprador no gateway ou cliente da organização)

## Exemplo

```bash cURL theme={null}
curl -X GET "https://api.chargefy.io/api/v1/buyers/lookup/joao@exemplo.com?organization_id=org_abc123" \
  -H "Content-Type: application/json"
```

```typescript SDK theme={null}
import { Chargefy } from '@chargefy/sdk';

const chargefy = new Chargefy({
  accessToken: process.env.CHARGEFY_ACCESS_TOKEN,
});

const result = await chargefy.buyers.lookup('joao@exemplo.com', {
  organizationId: 'org_abc123',
});
```

## Resposta de Exemplo

```json theme={null}
{
  "found": true,
  "source": "customer",
  "buyer": {
    "taxpayer_id": "12345678901",
    "first_name": "João",
    "last_name": "Silva",
    "email": "joao@exemplo.com",
    "phone_number": "11999990000",
    "birthdate": "15-06-1990",
    "zoop_buyer_id": "gw_buyer_abc123"
  },
  "local_data": {
    "buyer_id": "gw_buyer_abc123"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.