Skip to main content
GET
Doações políticas de uma empresa

Authorizations

token
string
query
required

Path Parameters

cnpj
string
required

CNPJ do doador (com ou sem formatação; não-dígitos são removidos)

Example:

"12345678000190"

Query Parameters

limit
integer
default:100

Tamanho da página (default 100; máximo 500 — valores fora da faixa são ajustados, não rejeitados)

Example:

100

offset
integer
default:0

Deslocamento da página (default 0; máximo 50000 — valores fora da faixa são ajustados)

Example:

0

ano
integer

Filtra pelo ano da eleição (ex.: 2022). Aplica-se também ao total e ao resumo

Example:

2022

uf
string

UF da prestação de contas do beneficiário (27 UFs + BR/VT/ZZ; case-insensitive)

Example:

"SP"

partido
string

Sigla do partido do beneficiário (case-insensitive)

Example:

"XYZ"

cargo
string

Cargo do beneficiário (ex.: Vereador, Deputado Federal; case-insensitive)

Example:

"Prefeito"

Response

Envelope com total, resumo agregado e página de doações. total 0 quando não há resultados ou o documento é inválido (crédito reembolsado) — nunca 404

documento
string

Documento consultado (apenas dígitos)

Example:

"12345678901"

tipo_documento
enum<string>
Available options:
cpf,
cnpj
Example:

"cpf"

nome
string | null

Nome do doador (Title Case; prioriza o nome na Receita Federal). null quando total = 0

Example:

"João Da Silva"

total
integer

Total de doações COM os filtros aplicados (não é o tamanho da página) — base da paginação. 0 = sem doações, documento inválido ou base indisponível (crédito reembolsado)

Example:

7

limit
integer

Tamanho da página aplicado (após clamp)

Example:

100

offset
integer

Deslocamento aplicado (após clamp)

Example:

0

resumo
object | null

Resumo agregado com os filtros aplicados; null quando total = 0

doacoes
object[]

Página de doações, ordenada por ano DESC e data DESC