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.

Show 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

cURL

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"

​

Resposta de Exemplo

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