Empresas

Empresas

curl --request GET \
  --url https://api.example.com/api/v1/empresas

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/v1/empresas",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/v1/empresas"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/v1/empresas")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

GET

api

empresas

Empresas

curl --request GET \
  --url https://api.example.com/api/v1/empresas

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/v1/empresas",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/v1/empresas"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/v1/empresas")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

Este endpoint tem dois modos. Sem cnae e comex, ele percorre o catálogo completo da Aurora em ordem estável de raiz do CNPJ. Com um desses filtros, ele seleciona o perfil no grafo e devolve o cadastro completo hidratado pela Aurora. É preciso criar no Brain uma chave com o acesso Cadastro de empresas (Aurora), que inclui o escopo aurora:read.

Catálogo completo

curl "https://brain.pandoragraph.com/api/v1/empresas?limite=100" \
  -H "Authorization: Bearer $BRAIN_API_KEY"

{
  "dado": {
    "total": 100,
    "itens": [
      {
        "id": "00000000",
        "versaoId": "emp_v1_...",
        "cnpjBasico": "00000000",
        "razaoSocial": "BANCO DO BRASIL SA",
        "naturezaJuridica": "2038",
        "qualificacaoResponsavel": "10",
        "capitalSocial": 120000000000,
        "capitalSocialTexto": "120000000000",
        "porte": "05",
        "enteFederativo": null,
        "primeiraAparicao": "2025-11-16",
        "ultimaAparicao": "2026-07-12"
      }
    ],
    "pagina": {
      "limite": 100,
      "temMais": true,
      "proximoCursor": "cursor_opaco"
    }
  },
  "avisos": [
    "capitalSocialTexto é a representação textual do double precision armazenado; não é patrimônio nem faturamento"
  ],
  "fonte": { "atualizadoEm": "2026-07-12", "cacheSegundos": 3600 },
  "fontes": {
    "aurora": { "estado": "ok", "snapshotId": "...", "completo": true }
  }
}

Envie o cursor sem alterá-lo e mantenha os mesmos filtros:

curl "https://brain.pandoragraph.com/api/v1/empresas?limite=100&cursor=$CURSOR" \
  -H "Authorization: Bearer $BRAIN_API_KEY"

O cursor é opaco, pertence à organização e preserva o snapshot da primeira página. Se esse snapshot sair da retenção, a API devolve 409 cursor_snapshot_expirado; reinicie sem cursor.

Perfil por CNAE e comércio exterior

curl "https://brain.pandoragraph.com/api/v1/empresas?cnae=6612603&comex=true&capitalMin=1000000&limite=100" \
  -H "Authorization: Bearer $BRAIN_API_KEY"

string

Um ou mais CNAEs de sete dígitos, separados por vírgula. Mais de um significa que a empresa pode corresponder a qualquer um deles.

boolean

true exige estabelecimento com comércio exterior. false não filtra.

number

Capital social cadastral mínimo. Só pode ser usado junto de cnae ou comex; não é patrimônio, faturamento nem estimativa de tamanho.

integer

default:"25"

De 1 a 100. A resposta pode trazer menos itens e ainda ter temMais: true; continue pelo cursor.

Histórico cadastral

curl "https://brain.pandoragraph.com/api/v1/empresas/00000000/historico?limite=100" \
  -H "Authorization: Bearer $BRAIN_API_KEY"

Cada item usa o mesmo formato cadastral do catálogo. primeiraAparicao e ultimaAparicao descrevem em quais cargas a versão foi observada; não são, necessariamente, datas jurídicas de início e fim.

Quadro societário

curl "https://brain.pandoragraph.com/api/v1/empresas/00000000/socios?modo=vigentes&limite=100" \
  -H "Authorization: Bearer $BRAIN_API_KEY"

modo=vigentes devolve as linhas presentes na carga do snapshot. Use modo=historico para todas as versões conhecidas. Esta rota exige também socios:read, registra o acesso e responde com Cache-Control: private, no-store.

vigente significa “presente na carga observada”, não uma data formal de saída. Constar no QSA não prova controle ou titularidade, e nomes iguais podem ser pessoas diferentes.

Limites e cache

Consultas Aurora têm teto distribuído de 300 unidades por minuto por organização e por chave. QSA custa duas unidades. Também há limite de quatro consultas Aurora simultâneas por organização. Ao exceder, a API responde 429 e Retry-After: 60. Respostas cadastrais usam cache privado por uma hora e variam por Authorization. Respostas com pessoas usam private, no-store.

⌘I

Começar

Endpoints

Catálogo completo

Perfil por CNAE e comércio exterior

Histórico cadastral

Quadro societário

Limites e cache

​Catálogo completo

​Perfil por CNAE e comércio exterior

​Histórico cadastral

​Quadro societário

​Limites e cache

Catálogo completo

Perfil por CNAE e comércio exterior

Histórico cadastral

Quadro societário

Limites e cache