Consulta de cedente
Consulta de Cedente Por Chave
Disponível em
| Perfil | Host | Permissão exigida |
|---|---|---|
| Gestora | manager-api | Leitura |
| Consultoria | consultant-api | Ler Cedentes |
| Cedente | assignor-api | Leitura |
URL base de cada host: Ambientes (Hosts).
Request
ENDPOINT
/assignor_registry/assignor_registry/ASSIGNOR_REGISTRY_KEYMÉTODO
GETResponse
STATUS
200Response 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
| Campo | Tipo | Descrição | Caracteres |
|---|---|---|---|
assignor_registry_key | string | Identificador do cadastro. | 36 |
name * | string | Nome do cedente. | 1 a 255 |
document_number * | string | Número de documento do cedente (CNPJ). | 14 a 18 |
status | string | Status do cadastro. | Ver Assignor Registry Status |
annual_revenues * | number | Declaração de faturamento anual do cedente, em inteiros. | Mínimo de 1 |
person_type * | string | Tipo de pessoa (física ou jurídica) do cedente. | - |
email * | string | Endereço de e-mail do cedente. | 1 a 255 |
is_in_national_financial_system * | boolean | Indicador se o cedente é integrante do SFN. | - |
phone | object | Objeto referenciando as informações do telefone do cedente. | Ver Definição de Telefone. |
address * | object | Objeto referenciando as informações do endereço do cedente. | Ver Definição de Endereço. |
related_parties * | array | Lista de partes relacionadas da empresa. | Ver Definição de Parte Relacionada. |
accounts * | array | Lista de contas de desembolso do cedente. | Ver Definição de Conta. |
guarantors * | array | Lista de avalistas do cedente. | Ver Definição de Avalista. |
last_analysis | object | Última análise do cadastro. | Ver Definição de Análise. |
signer_groups | array | Grupos de assinantes vigentes do cedente. | Ver Definição de Grupo de Assinantes. |
organization_level | string | headquarters (matriz), branch (filial) ou not_applicable. Só vem quando definido. | - |
headquarters_bond | boolean | true quando o cadastro é uma filial vinculada a uma matriz. | - |
Erros
| Status | Código | Quando acontece |
|---|---|---|
| 404 | ASR000004 | Cedente 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
| Perfil | Host | Permissão exigida |
|---|---|---|
| Gestora | manager-api | Leitura |
| Consultoria | consultant-api | Ler Cedentes |
| Cedente | assignor-api | Leitura |
URL base de cada host: Ambientes (Hosts).
Request
ENDPOINT
/assignor_registry/assignor_registriesMÉTODO
GETQuery params
| Campo | Tipo | Descrição | Caracteres |
|---|---|---|---|
name | string | Nome do cedente | 1-255 |
document_number | string | Número de documento do cedente | 1-18 |
assignor_registry_status | string | Status do cedente | 1-255 |
analysis_status | string | Status da análise mais recente | 1-255 |
limit | integer | Itens por página. Padrão 25 (10 na assignor-api), máximo 50. Acima do máximo, a API devolve 400 | - |
page | integer | Página, começando em 0. Use is_last_page da resposta para saber quando parar | - |
Response
STATUS
200Response 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
| Status | Código | Quando acontece |
|---|---|---|
| 400 | — | limit acima de 50 ou page negativo. |
| 404 | ASR000026 | O 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.