---
title: "CNPJs elegíveis"
method: GET
path: "/api/v1/brazilian_companies/eligible"
tags: ["Empresas Brasileiras"]
---

# CNPJs elegíveis

`GET /api/v1/brazilian_companies/eligible`

## Request

- Base URL: `https://app.oportunidados.com.br`
- URL: `https://app.oportunidados.com.br/api/v1/brazilian_companies/eligible`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `api_token`

Lista paginada por keyset (`after_cnpj`) dos CNPJs da coorte firmográfica. As quatro chaves `filter`, `count`, `next_cursor` e `data` estão sempre presentes. `data` é um array de CNPJs (14 posições). `next_cursor` é o último CNPJ quando a página enche, senão null. `filter` ecoa `require_matriz`, `portes`, `capital_social_min` e `n_filiais_min`; `situacoes` só entra quando o cliente envia.

Autenticação: `Authorization: Bearer <token_digest>` (preferida) ou query `api_token` (legado). Recusas 401/403/429/503 usam o JSON literal do controller e dos concerns.

Disponível conforme o plano (`api_search_enabled`). Cada chamada conta 1 na quota mensal. Limite de 30 chamadas por minuto por conta neste grupo de endpoints; `eligible` devolve até 1.000 CNPJs por página.

## Query parameters

- `api_token` string
- `require_matriz` boolean
- `portes` string
- `situacoes` string
- `capital_social_min` integer
- `n_filiais_min` integer
- `after_cnpj` string
- `limit` integer

## Response `200`

sucesso

- object
  - `filter` object, required
    - `require_matriz` boolean, required
    - `portes` string[], required
    - `capital_social_min` integer, required
    - `n_filiais_min` integer, required
    - `situacoes` string[]
  - `count` integer, required
  - `next_cursor` string, nullable, required
  - `data` string[], required

## Other responses

- `401`: não autorizado
- `403`: proibido
- `429`: muitas requisições
- `503`: timeout

---

[API](https://skmtc.dev/oportunidados/apis/api-de-dados-oportunidados-v1.md) · [All operations](https://skmtc.dev/oportunidados/apis/api-de-dados-oportunidados-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/oportunidados/apis/api-de-dados-oportunidados-v1/revisions/0af33d72cdb4?raw)