跳到主要内容

查询投资人

此端点允许通过唯一键查询系统中已登记投资人的完整详情。

Request​

ENDPOINT
/investor_management/investor/INVESTOR-KEY
MÉTODO
GET

Path Params​

字段类型描述字符数
INVESTOR-KEYstring投资人的唯一键（UUID v4）。36

Response​

STATUS
200
Response Body
{
    "investor_key": "07b1ac01-5fc4-475f-930b-19595f24bc1e",
    "name": "Fabrica Exemplo S.A.",
    "document_number": "96.146.194/0001-07",
    "status": "in_filling",
    "backoffice_analysis_status": "in_analysis",
    "person_type": "legal",
    "trading_name": "Fabrica Comércio",
    "cnae_code": "62.02-3-00",
    "company_type": "sa",
    "foundation_date": "2000-01-01",
    "address": {
      "street": "Rua das Empresas",
      "neighborhood": "Centro",
      "number": "123",
      "postal_code": "01001-000",
      "city": "São Paulo",
      "state": "SP",
      "complement": "Sala 101"
    },
    "registration_datetime": "2025-01-23T13:47:57.354528",
    "expiration_date": "2026-01-23",
    "signer_group_list": [],
    "bank_account_list": [],
    "investor_representative_list": [],
    "investor_contact_information_list": [],
    "investor_document_list": [],
    "investor_analysis_list": []
}

Response Body Params​

字段类型描述最大字符数
investor_keystring投资人的唯一标识符。36
namestring投资人全名。255
document_numberstring投资人证件号码（CNPJ）。14
statusstring投资人状态。status 枚举
backoffice_analysis_statusstring后台分析状态。-
person_typestring人员类型（legal 或 natural）。-
trading_namestring投资人商业名称。1023
cnae_codestring投资人的 CNAE 代码。10
company_typestring公司类型。50
foundation_datestring投资人成立日期。-
signer_group_listarray与投资人关联的签名人组列表。-
bank_account_listarray与投资人关联的银行账户列表。-
investor_representative_listarray投资人代表列表。-
investor_contact_information_listarray与投资人关联的联系信息列表。-
investor_document_listarray投资人已登记的文件列表。-
addressstring地址引用对象。address 对象

Address 对象​

字段类型描述最大字符数
streetstring公司地址街道名称。500
neighborhoodstring公司地址区域名称。100
numberstring地址门牌号。10
postal_codestring邮政编码（仅数字）。8
citystring地址城市名称。255
statestring州缩写（2个字符）。2
complementstring地址补充信息（如适用）。100

status 枚举​

枚举值描述
in_filling填写中
in_analysis分析中
canceled已取消
approved已批准
reproved未批准
expired已过期