> ## 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/accounts/onboarding/check

> Verifica se já existe um seller cadastrado para um determinado CPF ou CNPJ

Consulta se um seller (vendedor) já está registrado no gateway de pagamentos ou no banco de dados para o número de documento informado. Útil para evitar duplicidade antes de iniciar o processo de onboarding.

## Autenticação

Requer autenticação via **Supabase JWT** (usuário autenticado). O usuário deve ter acesso à organização informada.

## Parâmetros de Query

**documentNumber** `string` *required*

CPF (Pessoa Física) ou CNPJ (Pessoa Jurídica) do seller a verificar. Pode ser enviado com ou sem formatação.

**accountId** `string` *required*

ID da conta (`accounts`) associada à organização do usuário.

## Resposta

**exists** `boolean`

`true` se o seller já está cadastrado, `false` caso contrário.

**seller** `object`

Presente apenas quando `exists` é `true`.

**Propriedades**

**sellerId** `string`

ID do seller no gateway de pagamento

**status** `string`

Status do seller (ex: `pending`, `active`, `action_required`)

**type** `string`

Tipo do seller: `individual` ou `business`

**createdAt** `string`

Data de criação (ISO 8601)

**updatedAt** `string`

Data da última atualização (ISO 8601)

## Exemplo

```bash cURL theme={null}
curl -X GET "https://api.chargefy.io/api/v1/accounts/onboarding/check?documentNumber=12345678901&accountId=acc_abc123" \
  -H "Authorization: Bearer $CHARGEFY_ACCESS_TOKEN"
```

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

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

const result = await chargefy.accounts.onboarding.check({
  documentNumber: '12345678901',
  accountId: 'acc_abc123',
});
```

## Resposta de Exemplo

```json theme={null}
{
  "exists": true,
  "seller": {
    "sellerId": "seller_xyz456",
    "status": "pending",
    "type": "individual",
    "createdAt": "2026-03-01T10:00:00Z",
    "updatedAt": "2026-03-15T14:30:00Z"
  }
}
```

### Quando seller não existe

```json theme={null}
{
  "exists": false
}
```

## Erros

| Status | Descrição |
| - | - |
| `400` | `documentNumber` ou `accountId` não informados |
| `403` | Usuário não tem acesso à organização |
| `404` | Conta não encontrada |


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