Pular para o conteúdo principal

Consulta de cedente


Consulta de Cedente Por Chave​

Disponível em
PerfilHostPermissão exigida
Gestoramanager-apiLeitura
Consultoriaconsultant-apiLer Cedentes
Cedenteassignor-apiLeitura

URL base de cada host: Ambientes (Hosts).

Request​

ENDPOINT
/assignor_registry/assignor_registry/ASSIGNOR_REGISTRY_KEY
MÉTODO
GET

Response​

STATUS
200
Response Body
{
"assignor_registry_key": "c4295375-4077-4092-a258-5bcdf8875907",
"status": "registered",
"name": "Cedente Exemplo LTDA",
"document_number": "33.344.455/0001-83",
"person_type": "legal_person",
"email": "financeiro@cedente-exemplo.com.br",
"annual_revenues": 1000000,
"is_in_national_financial_system": true,
"address": {
"street": "Rua Maria Carolina",
"number": "624",
"neighborhood": "Jardim Paulistano",
"city": "São Paulo",
"postal_code": "01445-000",
"uf": "SP",
"country": "BRA"
},
"phone": {
"international_dial_code": "+55",
"area_code": "11",
"number": "936360268"
},
"related_parties": [
{
"name": "Natália Nascimento",
"document_number": "123.456.789-09",
"related_party_type": "attorney",
"nationality": "BRA",
"direct_beneficiary": true,
"is_representative": true,
"email": "natalia.nascimento@yopmail.com",
"phone": {
"international_dial_code": "+55",
"area_code": "11",
"number": "936360268"
}
},
{
"name": "Maria Vitoria",
"related_party_type": "president",
"nationality": "DEU",
"passport_number": "C01X00T47",
"direct_beneficiary": true,
"is_representative": false

},
{
"name": "Roberto Carlos",
"document_number": "969.698.790-03",
"related_party_type": "director",
"nationality": "BRA",
"direct_beneficiary": false,
"company_country": "NZL",
"company_registry_number": "4984037284610",
"is_representative": true,
"email": "roberto.carlos@yopmail.com",
"phone": {
"international_dial_code": "+64",
"area_code": "11",
"number": "936360268"
}
}
],
"accounts": [
{
"account_key": "3c53a94a-2b81-4837-b7eb-8e025e69d81c",
"account_branch": "0001",
"account_number": "7912584",
"account_digit": "1",
"account_type": "checking_account",
"status": "active",
"financial_institution_code": "329",
"financial_institution_ispb": "32402502",
"default_account": true,
"owner": { "document_number": "33.344.455/0001-83" },
"description": null
}
],
"guarantors": [],
"last_analysis": {
"analysis_key": "d7805a05-98a7-486b-a440-807f1d3d5691",
"analysis_number": 1,
"status": "pending_documents",
"analysis_datetime": "2026-01-15T14:32:10Z",
"analysis_related_parties": [
{
"analysis_related_party_key": "5cdcc13b-c67d-45f3-aa66-36cb4f178b59",
"name": "Roberto Carlos",
"document_number": "969.698.790-03",
"analysis_roles": [{ "related_party_type": "director" }],
"documents": []
},
{
"analysis_related_party_key": "d4c75c93-4aa9-4567-89c4-b49334927721",
"name": "Natália Nascimento",
"document_number": "123.456.789-09",
"analysis_roles": [{ "related_party_type": "attorney" }],
"documents": []
}
],
"documents": [],
"annotations": [],
"last_updated": "2026-01-15T14:32:10Z",
"analysis_origin_type": "assignor_registry",
"reproval_reason": null,
"reproval_details": null
}
}

Objeto Cedente​

CampoTipoDescriçãoCaracteres
assignor_registry_keystringIdentificador do cadastro.36
name *stringNome do cedente.1 a 255
document_number *stringNúmero de documento do cedente (CNPJ).14 a 18
statusstringStatus do cadastro.Ver Assignor Registry Status
annual_revenues *numberDeclaração de faturamento anual do cedente, em inteiros.Mínimo de 1
person_type *stringTipo de pessoa (física ou jurídica) do cedente.-
email *stringEndereço de e-mail do cedente.1 a 255
is_in_national_financial_system *booleanIndicador se o cedente é integrante do SFN.-
phoneobjectObjeto referenciando as informações do telefone do cedente.Ver Definição de Telefone.
address *objectObjeto referenciando as informações do endereço do cedente.Ver Definição de Endereço.
related_parties *arrayLista de partes relacionadas da empresa.Ver Definição de Parte Relacionada.
accounts *arrayLista de contas de desembolso do cedente.Ver Definição de Conta.
guarantors *arrayLista de avalistas do cedente.Ver Definição de Avalista.
last_analysisobjectÚltima análise do cadastro.Ver Definição de Análise.
signer_groupsarrayGrupos de assinantes vigentes do cedente.Ver Definição de Grupo de Assinantes.
organization_levelstringheadquarters (matriz), branch (filial) ou not_applicable. Só vem quando definido.-
headquarters_bondbooleantrue quando o cadastro é uma filial vinculada a uma matriz.-

Erros​

StatusCódigoQuando acontece
404ASR000004Cedente não encontrado para o assignor_registry_key informado. Verificar se o assignor_registry_key está correto (ou, para gestora e consultoria, se o cadastro pertence à sua integração).

Erros de autenticação, permissão e host: veja Erros da API.


Consulta Paginada de Cedentes​

Disponível em
PerfilHostPermissão exigida
Gestoramanager-apiLeitura
Consultoriaconsultant-apiLer Cedentes
Cedenteassignor-apiLeitura

URL base de cada host: Ambientes (Hosts).

Request​

ENDPOINT
/assignor_registry/assignor_registries
MÉTODO
GET

Query params​

CampoTipoDescriçãoCaracteres
namestringNome do cedente1-255
document_numberstringNúmero de documento do cedente1-18
assignor_registry_statusstringStatus do cedente1-255
analysis_statusstringStatus da análise mais recente1-255
limitintegerItens por página. Padrão 25 (10 na assignor-api), máximo 50. Acima do máximo, a API devolve 400-
pageintegerPágina, começando em 0. Use is_last_page da resposta para saber quando parar-

Response​

STATUS
200
Response Body
{
"data": [
{
"assignor_registry_key": "c4295375-4077-4092-a258-5bcdf8875907",
"status": "registered",
"name": "Cedente Exemplo LTDA",
"document_number": "33.344.455/0001-83",
"person_type": "legal_person",
"email": "financeiro@cedente-exemplo.com.br",
"annual_revenues": 1000000,
"is_in_national_financial_system": true,
"address": {
"street": "Rua Maria Carolina",
"number": "624",
"neighborhood": "Jardim Paulistano",
"city": "São Paulo",
"postal_code": "01445-000",
"uf": "SP",
"country": "BRA"
},
"phone": {
"international_dial_code": "+55",
"area_code": "11",
"number": "936360268"
},
"related_parties": [
{
"name": "Natália Nascimento",
"document_number": "123.456.789-09",
"related_party_type": "attorney",
"nationality": "BRA",
"direct_beneficiary": true,
"is_representative": true,
"email": "natalia.nascimento@yopmail.com",
"phone": {
"international_dial_code": "+55",
"area_code": "11",
"number": "936360268"
}
},
{
"name": "Maria Vitoria",
"related_party_type": "president",
"nationality": "DEU",
"passport_number": "C01X00T47",
"direct_beneficiary": true,
"is_representative": false

},
{
"name": "Roberto Carlos",
"document_number": "969.698.790-03",
"related_party_type": "director",
"nationality": "BRA",
"direct_beneficiary": false,
"company_country": "NZL",
"company_registry_number": "4984037284610",
"is_representative": true,
"email": "roberto.carlos@yopmail.com",
"phone": {
"international_dial_code": "+64",
"area_code": "11",
"number": "936360268"
}
}
],
"accounts": [
{
"account_key": "3c53a94a-2b81-4837-b7eb-8e025e69d81c",
"account_branch": "0001",
"account_number": "7912584",
"account_digit": "1",
"account_type": "checking_account",
"status": "active",
"financial_institution_code": "329",
"financial_institution_ispb": "32402502",
"default_account": true,
"owner": { "document_number": "33.344.455/0001-83" },
"description": null
}
],
"guarantors": [],
"last_analysis": {
"analysis_key": "d7805a05-98a7-486b-a440-807f1d3d5691",
"analysis_number": 1,
"status": "pending_documents",
"analysis_datetime": "2026-01-15T14:32:10Z",
"analysis_related_parties": [
{
"analysis_related_party_key": "5cdcc13b-c67d-45f3-aa66-36cb4f178b59",
"name": "Roberto Carlos",
"document_number": "969.698.790-03",
"analysis_roles": [{ "related_party_type": "director" }],
"documents": []
},
{
"analysis_related_party_key": "d4c75c93-4aa9-4567-89c4-b49334927721",
"name": "Natália Nascimento",
"document_number": "123.456.789-09",
"analysis_roles": [{ "related_party_type": "attorney" }],
"documents": []
}
],
"documents": [],
"annotations": [],
"last_updated": "2026-01-15T14:32:10Z",
"analysis_origin_type": "assignor_registry",
"reproval_reason": null,
"reproval_details": null
}
}
],
"limit": 10,
"page": 0,
"is_last_page": true
}

Erros​

StatusCódigoQuando acontece
400—limit acima de 50 ou page negativo.
404ASR000026O agente autenticado não está habilitado no cadastro de cedentes.

Erros de autenticação, permissão e host: veja Erros da API.


Consulta de Conjuntos de Assinantes​

A consulta dos assinantes vinculados ao cedente e suas partes relacionadas é feita através do endpoint paginado de conjuntos de assinantes (signer_group_sets), que retorna tanto os conjuntos padrão (main) gerados pela análise quanto os conjuntos customizados (custom) definidos pelo cliente.

Para a especificação completa do endpoint — incluindo filtros disponíveis (owner_key, owner_type, owner_document_number, product_type e status), paginação, formato de resposta e enumeradores —, consulte Consulta de Assinantes.