> ## 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/sdk/organizations/check-existing

> Verifica se já existe uma organização cadastrada para um determinado CPF/CNPJ e tipo de vendedor.

Verifica se já existe uma organização registrada na plataforma com o CPF ou CNPJ informado. Útil para evitar duplicidades durante o onboarding de novos vendedores em plataformas multivendedor.

## Autenticação

Requer **Organization Access Token (OAT)** via header `Authorization: Bearer`.

## Parâmetros de Query

**taxpayer\_id** `string` *required*

CPF ou CNPJ do vendedor (somente números). Exemplo: `12345678901` para CPF ou `12345678000195` para CNPJ.

**seller\_type** `string` *required*

Tipo do vendedor. Valores aceitos: `individual` (pessoa física) ou `business` (pessoa jurídica).

## Resposta

**exists** `boolean`

Indica se já existe ao menos uma organização cadastrada com o `taxpayer_id` informado.

**organizations** `array`

Lista de organizações encontradas para o `taxpayer_id` informado.

**organizations\[]**

**id** `string`

Identificador único da organização.

**name** `string`

Nome da organização.

**avatar\_url** `string`

URL do avatar/logo da organização.

## Exemplo

```bash cURL theme={null}
curl -X GET "https://api.chargefy.io/api/v1/sdk/organizations/check-existing?taxpayer_id=12345678901&seller_type=individual" \
  -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.sdk.organizations.checkExisting({
  taxpayer_id: '12345678901',
  seller_type: 'individual',
});
```

## Resposta de Exemplo

```json theme={null}
{
  "exists": true,
  "organizations": [
    {
      "id": "org_01j9abc111",
      "name": "Vendedor Alpha",
      "avatar_url": "https://cdn.chargefy.io/avatars/org_01j9abc111.png"
    }
  ]
}
```


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