> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.
# PGFN
> O que as empresas brasileiras devem à União: busque toda dívida ativa federal tributária, previdenciária e do FGTS por CNPJ, nome, estado, situação e valor, e some as dívidas de uma empresa.
A Procuradoria-Geral da Fazenda Nacional inscreve em dívida ativa toda
dívida federal que uma empresa não pagou: tributos como IRPJ, COFINS, PIS e o
Simples Nacional, contribuições previdenciárias e o FGTS. Cada dívida vem com
sua situação (em cobrança, negociada, garantida, suspensa por decisão
judicial), se está ajuizada e seu valor consolidado. Essas inscrições são
públicas por lei (CTN art. 198 §3º II).
Só empresas: cerca de 33 milhões de dívidas, atualizadas a cada publicação
trimestral da PGFN. Busque em todas, ou consulte uma empresa pelo CNPJ, ou pela
raiz de 8 caracteres para todos os estabelecimentos, e obtenha o total que
ela deve.
A fonte inteira, organizada e pronta para consultar: cada endpoint desta página responde em milissegundos. Cada resposta traz `as_of`: o quão atuais são os dados. [Como funcionam os datasets](/pt/datasets).
## Buscar dívidas
`POST /br/pgfn/debts-search/v1` Dataset
Busca em todas as dívidas de empresas por qualquer combinação de nome, CNPJ ou
raiz, regime, estado, situação, papel, ajuizamento e valor.
| Campo | Tipo | Notas |
| ----------------- | ------- | ---------------------------------------------------------------------------------------------------- |
| `query` | string | Opcional. Palavras do nome da empresa; sem stemming. |
| `document_number` | string | Opcional. Um CNPJ, com ou sem pontuação, ou sua raiz de 8 caracteres para todos os estabelecimentos. |
| `regime` | enum | Opcional. `nao_previdenciario`, `previdenciario` ou `fgts`. |
| `state` | string | Opcional. O estado da empresa, p. ex. `SP`. |
| `status_type` | enum | Opcional. `in_collection`, `tax_benefit`, `guaranteed`, `suspended_by_court` ou `in_negotiation`. |
| `debtor_type` | enum | Opcional. `principal`, `co_responsible` ou `joint`. |
| `in_court` | enum | Opcional. `yes`, `no` ou `any`. Por padrão `any`. |
| `amount_min` | number | Opcional. Valor mínimo em reais. Por padrão `0`. |
| `amount_max` | number | Opcional. Valor máximo em reais; `0` sem limite. Por padrão `0`. |
| `page` | integer | Opcional. Página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-50. Por padrão `20`. |
```bash theme={"dark"}
curl https://api.croma.run/br/pgfn/debts-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "query": "construtora", "in_court": "yes", "per_page": 10 }'
```
Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `total`, `page`, `per_page`, `total_pages`, `count` e `debts[]`, do maior para o menor valor.
Cada dívida traz `regime` (`nao_previdenciario`, `previdenciario` ou `fgts`), `inscription_number`, `document_number` (o CNPJ, 14 caracteres), `document` (`12.345.678/0001-90`), `cnpj_root`, `debtor_name`, `debtor_type` (`principal`, `co_responsible` ou `joint`), `state`, `responsible_unit`, `registering_unit` (FGTS), `collecting_entity` (`pgfn` ou `caixa`), `status_type` (`in_collection`, `tax_benefit`, `guaranteed`, `suspended_by_court` ou `in_negotiation`), `status` (a redação detalhada da PGFN), `revenue_type`, `registered_on` (`yyyy-mm-dd`), `in_court`, `amount` (reais, consolidado com os encargos legais) e `reference_month` (`yyyy-mm` da publicação).
Uma inscrição com vários devedores tem uma linha para cada um, e cada linha
traz o `amount` da inscrição inteira. Some apenas as linhas `principal`; a
consulta de devedor abaixo faz isso por você.
## As dívidas de uma empresa
`POST /br/pgfn/debtor/v1` Dataset
Soma o que uma empresa deve à União, por CNPJ ou por raiz.
| Campo | Tipo | Notas |
| ----------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `document_number` | string | **Obrigatório.** Um CNPJ, p. ex. `33.000.167/0001-01`, ou sua raiz de 8 caracteres, p. ex. `33000167`, para somar todos os estabelecimentos. |
```bash theme={"dark"}
curl https://api.croma.run/br/pgfn/debtor/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "document_number": "33.000.167/0001-01" }'
```
Retorna `found`, `document_number`, `as_of`, `reference_month`, `debtor_name`, `totals` e `debts[]` (as 50 maiores).
`totals` traz `debts` (toda dívida em que a empresa aparece), `principal_debts`, `principal_amount` (o que a empresa deve como devedora principal, em reais), `in_court_amount`, `by_regime` (`{ debts, amount }` por tipo de dívida) e `complete` (false quando a empresa tem mais de 10.000 dívidas e só as maiores foram somadas). As dívidas corresponsáveis e solidárias contam em `debts` mas não nos valores, pois repetem o valor de outro devedor.
Uma empresa que não deve à União nada inscrito pela PGFN retorna
`found: false` com HTTP 200, não um erro.
Esquemas, todos os campos de resposta e um playground interativo.