Skip to main content

Create Redemption Request


Request

ENDPOINT
/quota_distributor/investor/INVESTOR_KEY/redemption_request
METHOD
POST
STATUS
201
Request Body
{
"issuance_serie_key": "UUID",
"redemption_request_type": "gross_redemption_value" | "number_of_quotas" | "remaining_application_value" | "net_value_redemption",
"gross_redemption_value":0.00,
"net_value": 0.00,
"remaining_application_value":0.00,
"number_of_quotas":0.00000000,
"bank_account_key": "UUID",
"quotation_date": "yyyy-mm-dd"
}
warning
  • The redemption_request_type field defines whether the gross_redemption_value, remaining_application_value and number_of_quotas fields should be passed or not.

    • If gross_redemption_value, the gross_redemption_value field is required.
    • If remaining_application_value, the remaining_application_value field is required.
    • If number_of_quotas, the number_of_quotas field is required.
    • If net_value_redenotuib, the net_value field is required.
  • The bank_account_key field should be used for redemption settlement in a specific account of the investor. If no specific account is informed, the investor's primary account will be used

Body params

FieldTypeDescriptionRequired
issuance_serie_keystringUnique identifier key for the Issuance SeriesYes
redemption_request_typestringEnumerator for Redemption Request TypesYes
gross_redemption_valuefloatGross redemption value, without deducting IR and IOFNo
net_valuefloatNet redemption value, already discounting IR and IOFNo
remaining_application_valuefloatRemaining application valueNo
number_of_quotasfloatFinancial application valueNo
bank_account_keystringUnique identifier key for the investor's bank accountNo
quotation_datestringRedemption quotation dateNo

Redemption Request Types

EnumeratorDescription
gross_redemption_valueRedemption by gross value
number_of_quotasRedemption by number of quotas
remaining_application_valueRedemption by remaining position
net_value_redemptionRedemption by net value

Response

Response Body
{
"redemption_request_key": "UUID"
}