---
title: "Buscar empresas brasileiras (OAuth)"
method: GET
path: "/api/v1/brazilian_companies"
tags: ["Empresas Brasileiras"]
---

# Buscar empresas brasileiras (OAuth)

`GET /api/v1/brazilian_companies`

## Request

- Base URL: `https://app.oportunidados.com.br`
- URL: `https://app.oportunidados.com.br/api/v1/brazilian_companies`
- Auth: OAuth 2 (authorization code, authorization URL `/oauth/authorize`, token URL `/oauth/token`; client credentials, token URL `/oauth/token`, scopes: `brazilian_companies_read`)

Busca paginada de empresas brasileiras (CNPJ) para clientes OAuth/MCP. Escopo `brazilian_companies_read`. `per_page` é fixo em 20 e não é parâmetro. 401 sem token e 403 de escopo insuficiente vêm do `doorkeeper_authorize!` e respondem `head`, sem corpo. 403 com JSON é inelegibilidade ou quota mensal (`OauthEligibility` com `OAUTH_ELIGIBILITY_ENFORCED=on`).

## Query parameters

- `filter` string
- `q` string
- `cnpj` string
- `uf` string
- `city` string
- `cnae_fiscal` string
- `situacao_cadastral` string
- `porte` string
- `page` integer

## Response `200`

sucesso

- object
  - `data` OauthCompanySummary[], required
    - `cnpj` string, required: CNPJ da empresa, 14 posições, zero-padded
    - `razao_social` string, nullable, required: Razão social
    - `nome_fantasia` string, nullable, required: Nome fantasia
    - `cnae_fiscal` string, nullable, required: CNAE fiscal principal
    - `situacao_cadastral` string, nullable, required: Situação cadastral
    - `porte` string, nullable, required: Porte da empresa
    - `uf` string, nullable, required: UF
    - `municipio` string, required: Nome do município
  - `meta` object, required
    - `current_page` integer, required
    - `next_page` integer, nullable
    - `prev_page` integer, nullable
    - `total_pages` integer, required
    - `total_count` integer, required
    - `per_page` integer

## Other responses

- `401`: não autorizado — sem corpo (Doorkeeper responde head)
- `403`: proibido
- `503`: base sendo atualizada

---

[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)