Paginated Query of Financial Application Closings

Lists the daily closings (accounting position) of the financial applications, by fund class or by application.

By fund class

Available on

Profile	Host	Required permission
Manager	manager-api	Read

Base URL for each host: Environments (Hosts).

ENDPOINT

/quota/fund_class/FUND_CLASS_KEY/financial_application_closings

METHOD

GET

STATUS

200

Query Params

Parameter	Description
accounting_date	Specific closing accounting date (yyyy-mm-dd)
from_date	Period start date (yyyy-mm-dd)
to_date	Period end date (yyyy-mm-dd)
investor_document_number	Investor CPF/CNPJ
limit	Items per page (default 75, maximum 75)
page	Page, starting at 0 (default 0)

Attention

Send accounting_date or the from_date and to_date pair — never both. Without either of them, the API returns QTA000026; with both, QIT000001. Parameters outside this list are also rejected with QIT000001.

Results are ordered from the most recent accounting date to the oldest.

By investor and financial application

Available on

Profile	Host	Required permission
Manager	manager-api	Read

Base URL for each host: Environments (Hosts).

ENDPOINT

/quota/investor/INVESTOR_KEY/financial_application/FINANCIAL_APPLICATION_KEY/financial_application_closings

METHOD

GET

STATUS

200

Query Params

Parameter	Description
last_financial_application_closing	Boolean. When true, returns only the application's last closing (default false)
limit	Items per page (default 50, maximum 500)
page	Page, starting at 0 (default 0)

Response

Case 01: Successful query

{
    "data": [
        {
            "financial_application": {
                "financial_application_key": "UUID",
                "share_capital": 1000.0,
                "status": "quoted",
                "financial_application_type": "primary_market",
                "payment_method": "regular",
                "quotation_date": "2025-01-10",
                "investor": {
                    "investor_key": "UUID",
                    "name": "INVESTIDOR EXEMPLO",
                    "person_type": "natural_person"
                },
                "issuance_serie": {
                    "issuance_serie_key": "UUID"
                }
            },
            "total_value": 1012.35,
            "number_of_quotas": 998.12345678,
            "principal_value": 1000.0,
            "acquisition_cost": 1000.0,
            "yield_value": 12.35,
            "ir_value": 2.78,
            "iof_value": 0.0,
            "taxable_yield_value": 12.35,
            "accounting_date": "2025-01-31"
        }
    ],
    "limit": 75,
    "page": 0,
    "is_last_page": true
}

Field	Type	Description
data	array	List of Financial Application Closing objects
limit	int	Items per page
page	int	Returned page
is_last_page	boolean	true when there are no more pages

Financial Application Closing

Field	Type	Description
financial_application	object	Full financial application, in the format of Query Financial Application by Key
total_value	float	Total value of the application at closing
number_of_quotas	float	Number of quotas at closing
principal_value	float	Principal value at closing
acquisition_cost	float	Acquisition cost of the quotas at closing
yield_value	float	Gross yield
ir_value	float	IR
iof_value	float	IOF
taxable_yield_value	float	Taxable yield
accounting_date	string	Closing accounting date

Errors

Status	Code	When it happens
400	QTA000026	Query by class without accounting_date or the from_date/to_date pair
400	QIT000001	Invalid or unknown parameter, limit above 75, or accounting_date together with from_date/to_date
400	QIT000004	The fund does not belong to the manager
404	QTA000020	Investor not found (the API responds with the distributor-not-found error)
404	QTA000023	Financial application not found for the investor

Authentication, permission and host errors: see API Errors.