跳到主要内容

分页查询金融申请

分页列出某份额持有人或某基金类别的金融申请。

按份额持有人​

返回某份额持有人的金融申请。

适用范围
角色主机所需权限
管理人manager-api读取

各主机的 Base URL：环境（主机）。

ENDPOINT
/quota/investor/INVESTOR_KEY/financial_applications
MÉTODO
GET
STATUS
200

对于管理人，查询仅返回其自身基金中、且属于与其关联的投资者的申请。

Query Params​

参数描述
page页码，从 0 开始（默认 0）
limit每页条目数（默认 20，最大 500）
statusFinancial Application Status 列表
types类型列表：primary_market、secondary_market
issuance_serie_key按发行系列过滤
quotation_date计价日期（yyyy-mm-dd）
fund_class_document_number基金类别的 CNPJ
application_from_datetime日期/时间大于或等于该值的申请，格式为 yyyy-mm-ddTHH:MM:SSZ（UTC）
application_to_datetime日期/时间小于或等于该值的申请，格式为 yyyy-mm-ddTHH:MM:SSZ（UTC）

按基金类别​

返回管理人某基金类别的金融申请，按从新到旧排序。

适用范围
角色主机所需权限
管理人manager-api读取

各主机的 Base URL：环境（主机）。

ENDPOINT
/quota/fund_class/FUND_CLASS_KEY/financial_applications
MÉTODO
GET
STATUS
200

Query Params​

参数描述
page页码，从 0 开始（默认 0）
limit每页条目数（默认 20，最大 100）
statusFinancial Application Status 列表
investor_name投资者姓名的一部分（不区分大小写）
investor_document_number投资者 CPF/CNPJ
quotation_date计价日期（yyyy-mm-dd）
application_from_datetime日期/时间大于或等于该值的申请，格式为 yyyy-mm-ddTHH:MM:SSZ（UTC）
application_to_datetime日期/时间小于或等于该值的申请，格式为 yyyy-mm-ddTHH:MM:SSZ（UTC）

limit 超过最大值时返回 400。

Response​

两种查询返回相同的结构。data 中的每一项都是 按键查询金融申请 中所述的 Financial Application 对象。

{
    "data": [
        {
            "financial_application_key": "UUID",
            "share_capital": 1000.0,
            "status": "quoted",
            "financial_application_type": "primary_market",
            "quotation_date": "2025-01-10"
        }
    ],
    "limit": 20,
    "page": 0,
    "is_last_page": true
}
字段类型描述
dataarray金融申请列表
limitint每页条目数
pageint返回的页码
is_last_pageboolean没有更多页时为 true

错误​

状态代码发生情形
400QIT000001日期或日期/时间格式无效
400QIT000004该管理人不是该基金的管理人，或未与该投资者关联
404QTA000002未找到基金类别（按类别查询）

认证、权限和主机相关错误：参见 API 错误。