Create Financial Application

Creates a financial application of an investor in an issuance series.

Available on

Profile	Host	Required permission
Manager	manager-api	Write
Consultant	consultant-api	Granted by the integration team

Base URL for each host: Environments (Hosts).

Request

ENDPOINT

/quota/investor/INVESTOR_KEY/financial_application

METHOD

POST

STATUS

201

Request Body

{
    "issuance_serie_key": "UUID",
    "share_capital": 0.00,
    "payment_method": "b3 / regular",
    "central_depositary": "unregistered / cetip",
    "quotation_date": "yyyy-mm-dd"
}

Required fields

• issuance_serie_key
• share_capital

Attention

payment_method and central_depositary are optional. If they are not sent, the API uses the values marked as default in the table below (regular and unregistered).

• With central_depositary cetip, the payment_method can be regular or b3. With unregistered, only regular (b3 returns the QTA000359 error).

Body params

Field	Type	Description
issuance_serie_key	string	Unique identification key of the issuance series
share_capital	float	Financial application value (greater than or equal to 0). If the series has a minimum application value, the value must reach it
payment_method	string	Payment method. Expected values: • regular: Pix or TED (default) • b3: Via B3
central_depositary	string	Depositary type. Expected values: • unregistered: No registrar (default) • cetip: Registered at Cetip
quotation_date	string	Quotation date of the application, in the yyyy-mm-dd format (optional). It must be a business day and cannot be earlier than the fund's accounting date. If omitted, it is calculated from the series' term configuration

Response

The response carries the created financial application object, in the same format as the query by key. Keep the financial_application_key.

Response Body (summarized)

{
    "financial_application_key": "UUID",
    "share_capital": 1000.0,
    "status": "pending_payment",
    "financial_application_type": "primary_market",
    "payment_method": "regular",
    "central_depositary": "unregistered",
    "quotation_date": "2025-01-10"
}

Errors

Status	Code	When it happens
400	QIT000001	Invalid body: missing required field, wrong type or unexpected field
400	QIT000004	The series does not belong to a fund of the manager
400	QTA000359	payment_method b3 with central_depositary unregistered
400	QTA000272	share_capital below the series' minimum application value
400	QTA000176	quotation_date is not a business day
400	QTA000225	quotation_date earlier than the fund's accounting date
400	QTA000264	Value above what is available in the offering or in the subscription note (closed-end fund)
400	QTA000267	The investor's subscription note is not yet ready for subscription (closed-end fund)
400	QTA000269	The application would leave the sub class out of compliance (subordination ratio)
403	QTA000315	The consultant has no permission on the series' fund
404	QTA000004	Invalid value in payment_method or central_depositary
404	QTA000015	issuance_serie_key not found
404	QTA000021	Investor not found (on manager-api, the response currently comes as QTA000020)
404	QTA000265	The investor has no subscription note (closed-end fund)
404	QTA000266	The series has no quota offering (closed-end fund)
422	QTA000425	The issuance series has already been settled
422	QTA000357	Transaction blocked: the series has a zero or negative quota value

Authentication, permission and host errors: see API Errors.