Create Redemption Request

Creates a quota redemption request for an investor in an issuance series. Closed-end funds do not accept redemption requests.

Available on

Profile	Host	Required permission
Manager	manager-api	Write

Base URL for each host: Environments (Hosts).

Request

ENDPOINT

/quota/investor/INVESTOR_KEY/redemption_request

METHOD

POST

STATUS

201

Request Body

{
    "issuance_serie_key": "UUID",
    "redemption_request_type": "gross_redemption_value",
    "gross_redemption_value": 1000.0,
    "payment_method": "regular",
    "disbursement_account_key": "UUID",
    "quotation_date": "2025-01-15"
}

Attention

The redemption_request_type field defines which value field must be sent. Send only that field; sending a field of another type returns QTA000025.

• gross_redemption_value: send gross_redemption_value.
• remaining_application_value: send remaining_application_value.
• number_of_quotas: send number_of_quotas.
• net_value_redemption: send net_value.

The disbursement_account_key field indicates a specific investor account for the payment. Without it, the investor's main account is used.

Body params

Field	Type	Description	Required
issuance_serie_key	string	Unique key of the issuance series	Yes
redemption_request_type	string	Redemption Request Types enumerator	Yes
gross_redemption_value	float	Gross redemption value, before deducting IR and IOF	Conditional
net_value	float	Net redemption value, after deducting IR and IOF	Conditional
remaining_application_value	float	Remaining application value	Conditional
number_of_quotas	float	Number of quotas to redeem	Conditional
disbursement_account_key	string	Key of the investor's bank account that will receive the payment	No
quotation_date	string	Redemption quotation date (yyyy-mm-dd). Must be a business day and respect the series' terms	No
payment_method	string	Payment method: regular (default) or b3	No
reference_date	string	Redemption reference date (yyyy-mm-dd)	No
redemption_request_key	string	Key (UUID) to use for the request, if you want to define it	No

Fields outside this list are rejected with QIT000001.

Redemption Request Types

Enumerator	Description
gross_redemption_value	Redemption by gross value
number_of_quotas	Redemption by number of quotas
remaining_application_value	Redemption by remaining position
net_value_redemption	Redemption by net value

Response

The response carries the created redemption request, in the same format as the query by key. Keep the redemption_request_key.

Response Body (summarized)

{
    "redemption_request_key": "UUID",
    "redemption_request_type": "gross_redemption_value",
    "status": "pending_quote",
    "quotation_date": "2025-01-15",
    "payment_date": "2025-01-16",
    "payment_method": "regular"
}

Errors

Status	Code	When it happens
400	QTA000025	The value field of the chosen type is missing, or the field of another type was sent
400	QTA000190	Net value redemption of up to R$ 10.00 (except for an exempt investor)
400	QTA000241	There is already a remaining value redemption request on the same day
400	QTA000242	Insufficient available value because of locked quotas
400	QTA000176	quotation_date is not a business day
400	QTA000182	quotation_date earlier than the fund's accounting date
400	QTA000186	quotation_date earlier than the series' minimum quotation date
400	QTA000296	Investor of the nominee type
400	QIT000004	The manager is not linked to the investor
404	QTA000015	Issuance series not found
404	QTA000021	Investor not found
404	QTA000180	The fund is closed-end and does not accept redemption requests
404	QTA000239	The investor's net worth does not cover all requested redemptions
404	QTA000243	The investor has no redeemable application in this series
422	QTA000357	Transaction blocked: the series has a zero or negative quota value

Authentication, permission and host errors: see API Errors.