Paginated Financial Application Query

Lists the financial applications of a quotaholder or of a fund class, with pagination.

By quotaholder

Returns the financial applications of a quotaholder.

Available on

Profile	Host	Required permission
Manager	manager-api	Read

Base URL for each host: Environments (Hosts).

ENDPOINT

/quota/investor/INVESTOR_KEY/financial_applications

METHOD

GET

STATUS

200

For the manager, the query returns only applications in its own funds, and only from investors it is linked to.

Query Params

Parameter	Description
page	Page, starting at 0 (default 0)
limit	Items per page (default 20, maximum 500)
status	List of Financial Application Status
types	List of types: primary_market, secondary_market
issuance_serie_key	Filters by issuance series
quotation_date	Quotation date (yyyy-mm-dd)
fund_class_document_number	Fund class CNPJ
application_from_datetime	Applications with a date/time greater than or equal to the value, in the yyyy-mm-ddTHH:MM:SSZ format (UTC)
application_to_datetime	Applications with a date/time less than or equal to the value, in the yyyy-mm-ddTHH:MM:SSZ format (UTC)

By fund class

Returns the financial applications of a fund class of the manager, from the most recent to the oldest.

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_applications

METHOD

GET

STATUS

200

Query Params

Parameter	Description
page	Page, starting at 0 (default 0)
limit	Items per page (default 20, maximum 100)
status	List of Financial Application Status
investor_name	Part of the investor's name (case-insensitive)
investor_document_number	Investor CPF/CNPJ
quotation_date	Quotation date (yyyy-mm-dd)
application_from_datetime	Applications with a date/time greater than or equal to the value, in the yyyy-mm-ddTHH:MM:SSZ format (UTC)
application_to_datetime	Applications with a date/time less than or equal to the value, in the yyyy-mm-ddTHH:MM:SSZ format (UTC)

A limit above the maximum returns 400.

Response

Both queries return the same structure. Each item of data is the Financial Application object described in Query Financial Application by Key.

{
    "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
}

Field	Type	Description
data	array	List of financial applications
limit	int	Items per page
page	int	Returned page
is_last_page	boolean	true when there are no more pages

Errors

Status	Code	When it happens
400	QIT000001	Date or date/time in an invalid format
400	QIT000004	The manager is not the fund's manager or is not linked to the investor
404	QTA000002	Fund class not found (query by class)

Authentication, permission and host errors: see API Errors.