转让方查询
按 key 查询转让方
适用范围
| 角色 | 主机 | 所需权限 |
|---|---|---|
| 管理人 | manager-api | 读取 |
| 顾问 | consultant-api | View Assignors |
| 转让方 | assignor-api | 读取 |
各主机的 Base URL：环境（主机）。
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
}
}
转让方对象
| 字段 | 类型 | 描述 | 字符数 |
|---|---|---|---|
assignor_registry_key | string | 注册的标识。 | 36 |
name * | string | 转让方名称。 | 1 到 255 |
document_number * | string | 转让方的证件号（CNPJ）。 | 14 到 18 |
status | string | 注册状态。 | 见 Assignor Registry Status |
annual_revenues * | number | 转让方申报的年 营业收入，整数。 | 最小值 1 |
person_type * | string | 转让方的人员类型（自然人或法人）。 | - |
email * | string | 转让方的邮箱地址。 | 1 到 255 |
is_in_national_financial_system * | boolean | 指示转让方是否属于巴西国家金融体系（SFN）成员。 | - |
phone | object | 转让方电话信息对象。 | 见 电话定义。 |
address * | object | 转让方地址信息对象。 | 见 地址定义。 |
related_parties * | array | 公司关联方列表。 | 见 关联方定义。 |
accounts * | array | 转让方的放款账户列表。 | 见 账户定义。 |
guarantors * | array | 转让方的担保人列表。 | 见 担保人定义。 |
last_analysis | object | 该注册最近一次的审查。 | 见 审查定义。 |
signer_groups | array | 转让方当前有效的签署人组。 | 见 签署人组定义。 |
organization_level | string | headquarters（总部）、branch（分支机构）或 not_applicable。仅在已设置时返回。 | - |
headquarters_bond | boolean | 当该注册是关联到总部的分支机构时为 true。 | - |
错误
| 状态码 | 代码 | 触发条件 |
|---|---|---|
| 404 | ASR000004 | 未找到所提供 assignor_registry_key 对应的转让方。请检查 assignor_registry_key 是否正确（对于管理人和顾问，还需检查该注册是否属于您的集成）。 |
认证、权限和主机相关错误：参见 API 错误。
转让方分页查询
适用范围
| 角色 | 主机 | 所需权限 |
|---|---|---|
| 管理人 | manager-api | 读取 |
| 顾问 | consultant-api | View Assignors |
| 转让方 | assignor-api | 读取 |
各主机的 Base URL：环境（主机）。
Request
ENDPOINT
/assignor_registry/assignor_registriesMÉTODO
GETQuery params
| 字段 | 类型 | 描述 | 字符数 |
|---|---|---|---|
name | string | 转让方名称 | 1-255 |
document_number | string | 转让方的证件号 | 1-18 |
assignor_registry_status | string | 转让方状态 | 1-255 |
analysis_status | string | 最近一次审查的状态 | 1-255 |
limit | integer | 每页条目数。默认 25（assignor-api 中为 10），最大 50。超过最大值时，API 返回 400 | - |
page | integer | 页码，从 0 开始。使用响应中的 is_last_page 判断何时停止 | - |
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
}
错误
| 状态码 | 代码 | 触发条件 |
|---|---|---|
| 400 | — | limit 超过 50 或 page 为负数。 |
| 404 | ASR000026 | 已认证的代理方未在转让方注册中启用。 |
认证、权限和主机相关错误：参见 API 错误。
签署人组合查询
与转让方及其关联方关联的签署人，通过签署人组合（signer_group_sets）的分页端点查询，该端点既返回由审查生成的标准组合（main），也返回客户自定义的组合（custom）。
端点的完整规范——包括可用的筛选条件（owner_key、owner_type、owner_document_number、product_type 和 status）、分页、响应格式和枚举值——参见签署人查询。