CADIN - Cadastro de Entidades Credoras — Catálogo de APIs governamentais

Gestão Financeira da União / APIS em Destaque

CADIN - Cadastro de Entidades Credoras

Procuradoria-Geral da Fazenda Nacional (PGFN)

PGFN/PGDAU

Versão 2.0 - 08/08/2025

Base / Sistema: Novo Cadin

Disponível via Conecta

Federal Estadual Municipal

Api para gerenciamento de cadastro para acesso por entidades credoras

Principais Operações

Realiza uma operação em um registro na base de dados de devedores.

PUT https://apigateway.conectagov.estaleiro.serpro.gov.br/api-cadin-credora/v1/registro/{numeroTransacao}/{operacao}

Parâmetros de Entrada numeroTransacao

Número da transação a ser afetada

acao

Ação a ser realizada no registro: baixar, reativar, suspender

motivo

Motivo causador da ação

Parâmetros de Saída code

Código HTTP de retorno: 202: Sucesso; 400: Erro de cadastro; 403: Usuário sem autorização no Conecta.Gov; 500: Erro interno

Altera um registro na base de dados de devedores

PUT https://apigateway.conectagov.estaleiro.serpro.gov.br/api-cadin-credora/v1/registro/{numeroTransacao}/alterar

Parâmetros de Entrada numeroTransacao

Número da transação a ser afetada

motivo

Motivo da alteração no registro

nome

Nome do devedor

Parâmetros de Saída code

Código HTTP de retorno: 202: Sucesso 400: Erro de cadastro 403: Usuário sem autorização no Conecta.Gov 500: Erro interno

Inclui um ou mais registros na base de dados de devedores

POST https://apigateway.conectagov.estaleiro.serpro.gov.br/api-cadin-credora/v1/registro/{origem}/registrar

Parâmetros de Entrada origem

Código de origem da entidade credora

tipoCpfCnpj

Se o Número de identificação do contribuinte no Cadin é um CPF (1) ou CNPJ (2)

cpf_cnpj

Número de identificação do contribuinte no Cadin

nome

Nome

numeroReferencia

Número de referência da dívida na entidade credora

complementoReferencia

Complemento da referência

dataComunicacao

Data da comunicação do débito

dataInadimplencia

Data que deu origem ao débito

isn

Número de controle da credora

Parâmetros de Saída code

Código HTTP de retorno: 201: Sucesso 400: Erro de cadastro 403: Usuário sem autorização no Conecta.Gov 500: Erro interno

Consulta todos os registros armazenados para a origem, ni e referência

GET https://apigateway.conectagov.estaleiro.serpro.gov.br/api-cadin-credora/v1/registro/{origem}/{ni}/{referencia}/{cpfCnpj}

Parâmetros de Entrada origem

Código de origem da entidade credora

Número de identificação do contribuinte no Cadin

referencia

Número de referência da dívida na entidade credora

cpf_cnpj

Define se a busca será por 'cpf' ou 'cnpj'

Parâmetros de Saída cpfCnpj

Número de identificação do contribuinte no Cadin

tipoCpfCnpj

Se o Número de identificação do contribuinte no Cadin é um CPF (1) ou CNPJ (2)

nome

Nome referente ao registro

numeroTransacao

Número da transação como registrado no Cadin

numeroReferencia

Número de referência da dívida na entidade credora

complementoReferencia

Complemento da referência

dataComunicacao

Data da comunicação do débito

dataInadimplencia

Data que deu origem ao débito

origem

Código de origem da entidade credora

dataAtualizacao

Data da última atualização

motivo

Motivo da atualização, se houver

tipoAtualizacao

Tipo da última atualização realizada no registro

situacao

Situação atual do registro (Ativo, Baixado, Suspenso)

nomeInstituicao

Nome da instituição

instrucoes

Instruções de regularização, conforme cadastro pela instituição

code

Código HTTP de retorno: 200: Sucesso 400: Erro de cadastro 403: Usuário sem autorização no Conecta.Gov 404: Nenhum registro encontrado 500: Erro interno

Consulta o registro armazenado pelo número de transação

GET https://apigateway.conectagov.estaleiro.serpro.gov.br/api-cadin-credora/v1/registro/{transacao}/transacao

Parâmetros de Entrada transacao

Número da transação a ser consultada

Parâmetros de Saída cpfCnpj

Número de identificação do contribuinte no Cadin

tipoCpfCnpj

Se o Número de identificação do contribuinte no Cadin é um CPF (1) ou CNPJ (2)

nome

Nome referente ao registro

numeroTransacao

Número da transação como registrado no Cadin

numeroReferencia

Número de referência da dívida na entidade credora

complementoReferencia

Complemento da referência

dataComunicacao

Data da comunicação do débito

dataInadimplencia

Data que deu origem ao débito

origem

Código de origem da entidade credora

dataAtualizacao

Data da última atualização

motivo

Motivo da atualização, se houver

tipoAtualizacao

Tipo da última atualização realizada no registro

situacao

Situação atual do registro (Ativo, Baixado, Suspenso)

nomeInstituicao

Nome da instituição

instrucoes

Instruções de regularização, conforme cadastro pela instituição

code

Código HTTP de retorno: 200: Sucesso 400: Erro de cadastro 403: Usuário sem autorização no Conecta.Gov 404: Nenhum registro encontrado 500: Erro interno

Consulta a situação atual do cidadão através do seu CPF (não tem restrição de origens)

GET https://apigateway.conectagov.estaleiro.serpro.gov.br/api-cadin-credora/v1/registro/info/{cpf}/cpf

Parâmetros de Entrada cpf

Número do CPF a ser consultado

Parâmetros de Saída nome

Nome que está cadastrado no sistema como associado ao CPF solicitado

cpf

Número do CPF consultado

situação

Situação do CPF consultado

code

Código HTTP de retorno: 200: Sucesso 400: Erro de cadastro 403: Usuário sem autorização no Conecta.Gov 500: Erro interno

Consulta a situação atual da empresa através do seu CNPJ

GET https://apigateway.conectagov.estaleiro.serpro.gov.br/api-cadin-credora/v1/registro/info/{cnpj}/cnpj

Parâmetros de Entrada cnpj

Número do CNPJ a ser consultado

Parâmetros de Saída razaoSocial

Razão social que está cadastrada no sistema como associado ao CNPJ solicitado

cnpj

Número do CNPJ consultado

situacao

Indica se o CNPJ solicitado possui alguma pendência no sistema Cadin. Retorna “regular” ou “irregular”

code

Código HTTP de retorno: 200: Sucesso 400: Erro de cadastro 403: Usuário sem autorização no Conecta.Gov 500: Erro interno

Endpoints

Produção

https://cadin.pgfn.gov.br/cadastro-conectagov/apirest/registro/info/

Homologação

https://hom-novocadin.estaleiro.serpro.gov.br/cadastro-conectagov/ apirest/ registro/info/

Endpoints Access Token

Endpoint Access Token URL de Produção: https://apigateway.conectagov.estaleiro.serpro.gov.br/oauth2/jwt-token
Endpoint Access Token URL de Homologação: https://h-apigateway.conectagov.estaleiro.serpro.gov.br/oauth2/jwt-token

Endpoints APIs
Endpoint Produção API Consulta Contratante: https://apigateway.conectagov.estaleiro.serpro.gov.br/api-cadin-consulta-contratante/v1
Endpoint Produção API Consulta Credora : https://apigateway.conectagov.estaleiro.serpro.gov.br/api-cadin-consulta-credora/v1
Endpoint Homologação API Consulta Contratante: https://h-apigateway.conectagov.estaleiro.serpro.gov.br/api-cadin-consulta-contratante/v1
Endpoint Homologação API Consulta Credora: https://h-apigateway.conectagov.estaleiro.serpro.gov.br/api-cadin-consulta-credora/v1

Para gerar o token de acesso favos seguir as orientações do seguinte endereço: https://gerenciador-conecta.readthedocs.io/outras_informacoes_tecnicas.html

FAQ - Acesse o link abaixo se está com problema para acessar a API

https://www.gov.br/governodigital/pt-br/infraestrutura-nacional-de-dados/interoperabilidade/conecta-gov.br/acessar-os-servicos-do-conecta

Como Acessar

Para órgão Público Federal, Estadual e Municipal, siga as instruções de adesão ao Conecta gov.br

Quero acessar

Swagger

Documentação técnica

Contato do Responsável

PGFN/PGDAU (Autorizações e Dúvidas) (Área de Negócio)

cadin.pgdau@pgfn.gov.br

(61) 2025-5100

Horário comercial

PGFN/CDA (Autorizações) (Área de Negócio)

cda.pgfn@pgfn.gov.br

(61) 2025-5100

Horário comercial

PGFN/CGTI (Área Técnica)

cgti.pgfn@pgfn.gov.br cgti.sistemas@pgfn.gov.br

(61) 2025-4804

Horário comercial

Endpoints Access Token

Endpoints APIs