# Retrieve investments for a link Retrieve investments for an existing link. Endpoint: POST /api/br/investment-transactions/ Version: 1.223.0 Security: basicAuth ## Query parameters: - `omit` (string) Omit certain fields from being returned in the response. For more information, see our Filtering responses DevPortal article. - `fields` (string) Return only the specified fields in the response. For more information, see our Filtering responses DevPortal article. ## Request fields (application/json): - `link` (string, required) The you want to retrieve information for. Example: "c81a1dea-6dd6-4999-8b9f-541ee8197058" - `date_from` (string) The date from which you want to start getting data for, in format. ⚠️ The value of cannot be greater than . Example: "2020-08-05" - `date_to` (string) The date you want to stop getting data for, in format. ⚠️ The value of cannot be greater than today's date (in other words, no future dates). Example: "2020-10-05" - `save_data` (boolean) Indicates whether or not to persist the data in Belvo. By default, this is set to and we return a 201 Created response. When set to , the data won't be persisted and we return a 200 OK response. Example: true ## Response 200 fields (application/json): - `id` (string) Belvo's unique identifier for the current item. Example: "0d3ffb69-f83b-456e-ad8e-208d0998d71d" - `link` (string,null) The the data belongs to. Example: "30cb4806-6e00-48a4-91c9-ca55968576c8" - `collected_at` (string) The ISO-8601 timestamp when the data point was collected. Example: "2022-02-09T08:45:50.406032Z" - `created_at` (string) The ISO-8601 timestamp of when the data point was created in Belvo's database. Example: "2022-02-09T08:45:50.406032Z" - `investment` (object) - `investment.id` (string) The unique identifier created by Belvo used to reference the current investment. Example: "5359ddc5-31fc-4346-934b-cc24630a8d06" - `investment.type` (string) The type of investment: Can be either - () - () - () - () - () Example: "FIXED_INCOME_BANKING" - `investment.issuer_id_number` (string,null) The CNPJ number of the issuing institution. For Investment Funds, this is the CNPJ of the fund. > 🚧 Not applicable for investments. Example: "10187609364567" - `investment.isin_number` (string,null) The ISO-6166 International Securities Identification Number (ISIN) for the financial instrument. Example: "BRCST4CTF001" - `investment.currency` (string) The three-letter currency code (ISO-4217) of the investment. For example, for Brazilian Real. Example: "BRL" - `investment.product_name` (string) The name of the investment product. - For , this can be: CDB, RDB, LCI, or LCA. - For , this can be: DEBENTURES, CRI, or CRA. - For , this will be the name of the fund. For example: CONSTELLATION MASTER FIA - For , this will be the name of the bond. For example: Tesouro Selic 2025. - For , this will be the name of the stock. For example AAPL. Example: "CONSTELLATION MASTER FIA" - `investment.is_tax_exempt` (boolean) Indicates if the investment is exempt from taxes. > 🚧 Only applicable for investments. - `investment.clearing_code` (string,null) The clearing code of the investment. > 🚧 Only applicable for and . Example: "CDB421GPXXX" - `investment.due_date` (string,null) The maturity date of the financial instrument. > 🚧 Only applicable for , , and investments. Example: "2022-01-01" - `investment.issue_date` (string,null) The date the financial instrument was issued. > 🚧 Only applicable for and . Example: "2021-01-01" - `investment.purchase_date` (string,null) The date the financial instrument was purchased. > 🚧 Only applicable for , , and investments. Example: "2021-01-01" - `investment.grace_period_date` (string,null) The grace period date of the financial instrument. > 🚧 Only applicable for and . Example: "2021-01-01" - `investment.issue_unit_price` (number,null) The unit price of the financial instrument at the time of issuance. > 🚧 Only applicable for and . Example: 1000 - `investment.balance` (object) The balance of the investment instrument, as of the . - `investment.balance.reference_date` (string) The date and time that the balance was calculated for the investment instrument, in format. Example: "2022-07-21T17:32:00Z" - `investment.balance.gross_value` (number) The gross value of the investment instrument. Example: 1000 - `investment.balance.blocked_amount` (number) The amount of the investment instrument that is blocked or unavailable for transactions. Example: 100 - `investment.balance.quantity` (number) The number of units, quotas, or assets held on the reference date. Example: 100 - `investment.balance.gross_unit_price` (number,null) The current gross unit value of the investment on the reference date Example: 10 - `investment.balance.net_value` (number,null) The net value of the investment after deductions for taxes, fees, and other charges, as of the reference date. Example: 900 - `investment.balance.withheld_amount` (number,null) The amount of the investment instrument that has been withheld or deducted from the net value. Example: 10 - `investment.balance.transaction_fee` (number,null) The fees and taxes charged for the transaction. Example: 5 - `investment.balance.purchase_unit_price` (number,null) The unit price at the time of purchase for the security or asset. Example: 10 - `investment.balance.pre_fixed_rate` (number,null) The pre-fixed remuneration rate for the income product. Example: 0.05 - `investment.balance.post_fixed_rate` (number,null) The percentage of the post-fixed indexer for the income product. Example: 0.05 - `investment.balance.penalty_fee` (number,null) The penalty (fine) for delays in payments, as defined in the contract. Example: 10 - `investment.balance.late_payment_fee` (number,null) The interest charged for delayed payments. Example: 10 - `investment.balance.closing_price` (number,null) The closing price of the investment on the reference date. Example: 10 - `investment.balance.unit_price_factor` (number,null) The factor used to calculate the unit price. Example: 1 - `investment.remuneration` (object) The remuneration details of the investment instrument. - `investment.remuneration.pre_fixed_rate` (number,null) The fixed interest rate defined at issuance, expressed as a decimal (for example represents 15%). Example: 0.05 - `investment.remuneration.post_fixed_rate` (number,null) The post-fixed interest rate defined at issuance, expressed as a decimal (for example represents 15%). Example: 0.05 - `investment.remuneration.rate_type` (string,null) The type of remuneration rate applied to the financial instrument. Can be either: - - Example: "LINEAR" - `investment.remuneration.rate_periodicity` (string,null) The frequency that the remuneration rate is applied to the financial instrument. Can be either: - - - - Example: "MENSAL" - `investment.remuneration.calculation_base` (string,null) Indicates whether the remuneration or interest calculation is based on business days () or calendar days (). - - Example: "DIAS_CORRIDOS" - `investment.remuneration.indexer` (string,null) The index used as a reference to calculate the profitability or returns of the financial instrument. Can be one either: - - - - - - - - - - - - Example: "CDI" - `investment.remuneration.indexer_additional_info` (string,null) Additional information regarding the rate. Required when is set to . Example: "IPCA + 5%" - `investment.classification_details` (object,null) The classification details of the investment instrument. > 🚧 Only applicable for investments. > > This object is only applicable for investments. For all other investment types, this object will be . - `investment.classification_details.category` (string,null) The investment fund's category, as defined by ANBIMA's classification standards. Can be one of: - - - - Example: "ACOES" - `investment.classification_details.class` (string,null) The class within the investment fund's category, as defined by ANBIMA's classification standards. Example: "Ações Livre" - `investment.classification_details.subclass` (string,null) The subclass of the investment fund, as defined by ANBIMA's classification standards. Example: "Ações Livre" - `investment.voucher_payment_details` (object) The voucher payment (also known as coupon payments) details of the investment instrument. > 🚧 Only applicable for and investments. > > This object is only applicable for and investments. For all other investment types, this object will be . - `investment.voucher_payment_details.is_voucher_payment` (boolean) Indicates whether the financial instrument pays periodic interest (voucher payments). Example: true - `investment.voucher_payment_details.periodicity` (string,null) The frequency that the voucher payments are made. Required when is set to . Can be one of: - - - - - - Example: "MENSAL" - `investment.voucher_payment_details.periodicity_additional_info` (string,null) Additional information about the voucher payment periodicity. Required when is set to . Example: "30/360" - `investment.debtor_details` (object,null) The debtor details of the investment instrument. > 🚧 Only applicable for investments. > > This object is only applicable for investments. For all other investment types, this object will be . - `investment.debtor_details.name` (string) The name of the debtor. Example: "Roberto Marino" - `investment.debtor_details.id_document_number` (string) The debtor's identification document number (CNPJ). Example: 12345678901 - `internal_identification` (string) The institution's internal identification of the investment transaction. Example: "ABCD2126019929279212650822221989319253344" - `value_date` (string) The date on which the transaction was settled, in format. > 📘 > > For investments, you will only receive transactions up until the last trading date. For example, if today is 19.11.2024, you will only receive transactions up till 18.11.2024. > 📘 > > For investments, this is the date when the transaction (purchase or redemption) is officially processed into fund shares or quotas. For purchases, this is the date the investor’s money is applied to acquire fund shares. For redemptions, this is the date when the fund shares are officially converted back into cash. Example: "2024-11-18" - `gross_value` (number) The gross value of the transaction. > 🚧 Not applicable for investments. Example: 60 - `net_value` (number) The net value of the transaction. > 🚧 Not applicable for investments. Example: 60 - `value` (number) The value of the transaction. For , this is the value of the trade executed by the client. If the client buys or sells stocks, this field indicates the total value of the trade (for example, the price per share × quantity). For , this is the value requested by the client for a fund transaction. > 🚧 Only applicable for and investments. Example: 60 - `unit_price` (number) The price for an individual unit or quota. Example: 3 - `price_factor` (number) The number of units (shares) considered when calculating the price per share or unit for a transaction. > 🚧 Only applicable for investments. Example: 1 - `transaction_tax` (number) The Financial Transaction Tax () applied or withheld during the transaction. > 🚧 Not applicable for investments. - `income_tax` (number) The Income Tax () applied or withheld during the transaction. > 🚧 Not applicable for investments. - `quantity` (number) The number of units, quotas, or assets involved in a transaction. Example: 20 - `type` (string) The transaction type ( or ) from the investment perspective. Enum: "INFLOW", "OUTFLOW", "null" - `subtype` (string) The transaction subtype. - For : APLICACAO, RESGATE, CANCELAMENTO, VENCIMENTO, PAGAMENTO_JUROS, AMORTIZACAO, TRANSFERENCIA_TITULARIDADE, TRANSFERENCIA_CUSTODIA, OUTROS. - For : COMPRA, VENDA, CANCELAMENTO, VENCIMENTO, PAGAMENTO_JUROS, AMORTIZACAO, PRÊMIO, TRANSFERENCIA_TITULARIDADE, TRANSFERENCIA_CUSTODIA, MULTA, MORA, OUTROS. - For : COMPRA, VENDA, DIVIDENDOS, JCP, ALUGUEIS, TRANSFERENCIA_TITULARIDADE, OUTROS. - For : AMORTIZACAO, TRANSFERENCIA_DE_COTAS, APLICACAO, RESGATE, COME_COTAS, OUTROS. - For : COMPRA, VENDA, CANCELAMENTO, VENCIMENTO, PAGAMENTO_JUROS, AMORTIZACAO, TRANSFERENCIA_TITULARIDADE, TRANSFERENCIA_CUSTODIA, OUTROS. - `subtype_additional_info` (string) Additional information about the transaction subtype. This field is mandatory when the subtype is . - `indexer_percentage` (number) The maximum percentage of the indexer for the contract (Bancaria) or transaction (Credito). > 🚧 Only applicable for and investments. - `rate` (number) The remuneration rate applied to the transaction. > 🚧 Only applicable for , , and investments. - `exit_fee` (number) The exit fee applied to the Investment Fund (Fundos de Investimento) transaction. This fee is charged when a client redeems or exits the fund. > 🚧 Only applicable for investments. - `broker_note_details` (object,null) Details regarding the broker note that is associated with this transaction. This object is only returned for transactions that are associated with a investment type. > 📘 Info > > A broker note () is an official document issued by a brokerage detailing the transactions made by an investor on a given day. It includes information on the gross value of all purchases and sales, brokerage fees, clearing and settlement fees, clearing and registration fees, stock exchange asset trade notice fees, stock exchange fees, clearing custody fees, taxes, and income tax withheld at source. - `broker_note_details.broker_note_number` (string, required) The broker note number. Example: "1854009930314350" - `broker_note_details.gross_value` (number, required) The gross value of all purchases and sales for the day. Example: 1000 - `broker_note_details.brokerage_fee` (number, required) The total brokerage fee charged for the day. Example: 10 - `broker_note_details.clearing_settlement_fee` (number, required) The fee charged for clearing and settlement in custody. Example: 2.5 - `broker_note_details.clearing_registration_fee` (number, required) The fee charged for clearing and registration in custody. Example: 1 - `broker_note_details.stock_exchange_asset_trade_notice_fee` (number, required) The fee charged by the stock exchange for asset trade notifications. Example: 0.5 - `broker_note_details.stock_exchange_fee` (number, required) The fee charged by the stock exchange for registry services. Example: 3 - `broker_note_details.clearing_custody_fee` (number, required) The fee charged by financial institutions for custody services. Example: 1.5 - `broker_note_details.taxes` (number, required) The total amount taxes charged on the transaction for the day, excluding income tax withheld at source. Example: 10 - `broker_note_details.income_tax` (number, required) The total amount of income tax withheld at the source for the day. Example: 5 - `broker_note_details.net_value` (number, required) The net value of the broker note after deducting expenses for brokerage fees, clearing settlement fees, registration fees, ANA fees, emoluments, custody fees, taxes, and IRRF Example: 980 ## Response 201 fields (application/json): - `id` (string) Belvo's unique identifier for the current item. Example: "0d3ffb69-f83b-456e-ad8e-208d0998d71d" - `link` (string,null) The the data belongs to. Example: "30cb4806-6e00-48a4-91c9-ca55968576c8" - `collected_at` (string) The ISO-8601 timestamp when the data point was collected. Example: "2022-02-09T08:45:50.406032Z" - `created_at` (string) The ISO-8601 timestamp of when the data point was created in Belvo's database. Example: "2022-02-09T08:45:50.406032Z" - `investment` (object) - `investment.id` (string) The unique identifier created by Belvo used to reference the current investment. Example: "5359ddc5-31fc-4346-934b-cc24630a8d06" - `investment.type` (string) The type of investment: Can be either - () - () - () - () - () Example: "FIXED_INCOME_BANKING" - `investment.issuer_id_number` (string,null) The CNPJ number of the issuing institution. For Investment Funds, this is the CNPJ of the fund. > 🚧 Not applicable for investments. Example: "10187609364567" - `investment.isin_number` (string,null) The ISO-6166 International Securities Identification Number (ISIN) for the financial instrument. Example: "BRCST4CTF001" - `investment.currency` (string) The three-letter currency code (ISO-4217) of the investment. For example, for Brazilian Real. Example: "BRL" - `investment.product_name` (string) The name of the investment product. - For , this can be: CDB, RDB, LCI, or LCA. - For , this can be: DEBENTURES, CRI, or CRA. - For , this will be the name of the fund. For example: CONSTELLATION MASTER FIA - For , this will be the name of the bond. For example: Tesouro Selic 2025. - For , this will be the name of the stock. For example AAPL. Example: "CONSTELLATION MASTER FIA" - `investment.is_tax_exempt` (boolean) Indicates if the investment is exempt from taxes. > 🚧 Only applicable for investments. - `investment.clearing_code` (string,null) The clearing code of the investment. > 🚧 Only applicable for and . Example: "CDB421GPXXX" - `investment.due_date` (string,null) The maturity date of the financial instrument. > 🚧 Only applicable for , , and investments. Example: "2022-01-01" - `investment.issue_date` (string,null) The date the financial instrument was issued. > 🚧 Only applicable for and . Example: "2021-01-01" - `investment.purchase_date` (string,null) The date the financial instrument was purchased. > 🚧 Only applicable for , , and investments. Example: "2021-01-01" - `investment.grace_period_date` (string,null) The grace period date of the financial instrument. > 🚧 Only applicable for and . Example: "2021-01-01" - `investment.issue_unit_price` (number,null) The unit price of the financial instrument at the time of issuance. > 🚧 Only applicable for and . Example: 1000 - `investment.balance` (object) The balance of the investment instrument, as of the . - `investment.balance.reference_date` (string) The date and time that the balance was calculated for the investment instrument, in format. Example: "2022-07-21T17:32:00Z" - `investment.balance.gross_value` (number) The gross value of the investment instrument. Example: 1000 - `investment.balance.blocked_amount` (number) The amount of the investment instrument that is blocked or unavailable for transactions. Example: 100 - `investment.balance.quantity` (number) The number of units, quotas, or assets held on the reference date. Example: 100 - `investment.balance.gross_unit_price` (number,null) The current gross unit value of the investment on the reference date Example: 10 - `investment.balance.net_value` (number,null) The net value of the investment after deductions for taxes, fees, and other charges, as of the reference date. Example: 900 - `investment.balance.withheld_amount` (number,null) The amount of the investment instrument that has been withheld or deducted from the net value. Example: 10 - `investment.balance.transaction_fee` (number,null) The fees and taxes charged for the transaction. Example: 5 - `investment.balance.purchase_unit_price` (number,null) The unit price at the time of purchase for the security or asset. Example: 10 - `investment.balance.pre_fixed_rate` (number,null) The pre-fixed remuneration rate for the income product. Example: 0.05 - `investment.balance.post_fixed_rate` (number,null) The percentage of the post-fixed indexer for the income product. Example: 0.05 - `investment.balance.penalty_fee` (number,null) The penalty (fine) for delays in payments, as defined in the contract. Example: 10 - `investment.balance.late_payment_fee` (number,null) The interest charged for delayed payments. Example: 10 - `investment.balance.closing_price` (number,null) The closing price of the investment on the reference date. Example: 10 - `investment.balance.unit_price_factor` (number,null) The factor used to calculate the unit price. Example: 1 - `investment.remuneration` (object) The remuneration details of the investment instrument. - `investment.remuneration.pre_fixed_rate` (number,null) The fixed interest rate defined at issuance, expressed as a decimal (for example represents 15%). Example: 0.05 - `investment.remuneration.post_fixed_rate` (number,null) The post-fixed interest rate defined at issuance, expressed as a decimal (for example represents 15%). Example: 0.05 - `investment.remuneration.rate_type` (string,null) The type of remuneration rate applied to the financial instrument. Can be either: - - Example: "LINEAR" - `investment.remuneration.rate_periodicity` (string,null) The frequency that the remuneration rate is applied to the financial instrument. Can be either: - - - - Example: "MENSAL" - `investment.remuneration.calculation_base` (string,null) Indicates whether the remuneration or interest calculation is based on business days () or calendar days (). - - Example: "DIAS_CORRIDOS" - `investment.remuneration.indexer` (string,null) The index used as a reference to calculate the profitability or returns of the financial instrument. Can be one either: - - - - - - - - - - - - Example: "CDI" - `investment.remuneration.indexer_additional_info` (string,null) Additional information regarding the rate. Required when is set to . Example: "IPCA + 5%" - `investment.classification_details` (object,null) The classification details of the investment instrument. > 🚧 Only applicable for investments. > > This object is only applicable for investments. For all other investment types, this object will be . - `investment.classification_details.category` (string,null) The investment fund's category, as defined by ANBIMA's classification standards. Can be one of: - - - - Example: "ACOES" - `investment.classification_details.class` (string,null) The class within the investment fund's category, as defined by ANBIMA's classification standards. Example: "Ações Livre" - `investment.classification_details.subclass` (string,null) The subclass of the investment fund, as defined by ANBIMA's classification standards. Example: "Ações Livre" - `investment.voucher_payment_details` (object) The voucher payment (also known as coupon payments) details of the investment instrument. > 🚧 Only applicable for and investments. > > This object is only applicable for and investments. For all other investment types, this object will be . - `investment.voucher_payment_details.is_voucher_payment` (boolean) Indicates whether the financial instrument pays periodic interest (voucher payments). Example: true - `investment.voucher_payment_details.periodicity` (string,null) The frequency that the voucher payments are made. Required when is set to . Can be one of: - - - - - - Example: "MENSAL" - `investment.voucher_payment_details.periodicity_additional_info` (string,null) Additional information about the voucher payment periodicity. Required when is set to . Example: "30/360" - `investment.debtor_details` (object,null) The debtor details of the investment instrument. > 🚧 Only applicable for investments. > > This object is only applicable for investments. For all other investment types, this object will be . - `investment.debtor_details.name` (string) The name of the debtor. Example: "Roberto Marino" - `investment.debtor_details.id_document_number` (string) The debtor's identification document number (CNPJ). Example: 12345678901 - `internal_identification` (string) The institution's internal identification of the investment transaction. Example: "ABCD2126019929279212650822221989319253344" - `value_date` (string) The date on which the transaction was settled, in format. > 📘 > > For investments, you will only receive transactions up until the last trading date. For example, if today is 19.11.2024, you will only receive transactions up till 18.11.2024. > 📘 > > For investments, this is the date when the transaction (purchase or redemption) is officially processed into fund shares or quotas. For purchases, this is the date the investor’s money is applied to acquire fund shares. For redemptions, this is the date when the fund shares are officially converted back into cash. Example: "2024-11-18" - `gross_value` (number) The gross value of the transaction. > 🚧 Not applicable for investments. Example: 60 - `net_value` (number) The net value of the transaction. > 🚧 Not applicable for investments. Example: 60 - `value` (number) The value of the transaction. For , this is the value of the trade executed by the client. If the client buys or sells stocks, this field indicates the total value of the trade (for example, the price per share × quantity). For , this is the value requested by the client for a fund transaction. > 🚧 Only applicable for and investments. Example: 60 - `unit_price` (number) The price for an individual unit or quota. Example: 3 - `price_factor` (number) The number of units (shares) considered when calculating the price per share or unit for a transaction. > 🚧 Only applicable for investments. Example: 1 - `transaction_tax` (number) The Financial Transaction Tax () applied or withheld during the transaction. > 🚧 Not applicable for investments. - `income_tax` (number) The Income Tax () applied or withheld during the transaction. > 🚧 Not applicable for investments. - `quantity` (number) The number of units, quotas, or assets involved in a transaction. Example: 20 - `type` (string) The transaction type ( or ) from the investment perspective. Enum: "INFLOW", "OUTFLOW", "null" - `subtype` (string) The transaction subtype. - For : APLICACAO, RESGATE, CANCELAMENTO, VENCIMENTO, PAGAMENTO_JUROS, AMORTIZACAO, TRANSFERENCIA_TITULARIDADE, TRANSFERENCIA_CUSTODIA, OUTROS. - For : COMPRA, VENDA, CANCELAMENTO, VENCIMENTO, PAGAMENTO_JUROS, AMORTIZACAO, PRÊMIO, TRANSFERENCIA_TITULARIDADE, TRANSFERENCIA_CUSTODIA, MULTA, MORA, OUTROS. - For : COMPRA, VENDA, DIVIDENDOS, JCP, ALUGUEIS, TRANSFERENCIA_TITULARIDADE, OUTROS. - For : AMORTIZACAO, TRANSFERENCIA_DE_COTAS, APLICACAO, RESGATE, COME_COTAS, OUTROS. - For : COMPRA, VENDA, CANCELAMENTO, VENCIMENTO, PAGAMENTO_JUROS, AMORTIZACAO, TRANSFERENCIA_TITULARIDADE, TRANSFERENCIA_CUSTODIA, OUTROS. - `subtype_additional_info` (string) Additional information about the transaction subtype. This field is mandatory when the subtype is . - `indexer_percentage` (number) The maximum percentage of the indexer for the contract (Bancaria) or transaction (Credito). > 🚧 Only applicable for and investments. - `rate` (number) The remuneration rate applied to the transaction. > 🚧 Only applicable for , , and investments. - `exit_fee` (number) The exit fee applied to the Investment Fund (Fundos de Investimento) transaction. This fee is charged when a client redeems or exits the fund. > 🚧 Only applicable for investments. - `broker_note_details` (object,null) Details regarding the broker note that is associated with this transaction. This object is only returned for transactions that are associated with a investment type. > 📘 Info > > A broker note () is an official document issued by a brokerage detailing the transactions made by an investor on a given day. It includes information on the gross value of all purchases and sales, brokerage fees, clearing and settlement fees, clearing and registration fees, stock exchange asset trade notice fees, stock exchange fees, clearing custody fees, taxes, and income tax withheld at source. - `broker_note_details.broker_note_number` (string, required) The broker note number. Example: "1854009930314350" - `broker_note_details.gross_value` (number, required) The gross value of all purchases and sales for the day. Example: 1000 - `broker_note_details.brokerage_fee` (number, required) The total brokerage fee charged for the day. Example: 10 - `broker_note_details.clearing_settlement_fee` (number, required) The fee charged for clearing and settlement in custody. Example: 2.5 - `broker_note_details.clearing_registration_fee` (number, required) The fee charged for clearing and registration in custody. Example: 1 - `broker_note_details.stock_exchange_asset_trade_notice_fee` (number, required) The fee charged by the stock exchange for asset trade notifications. Example: 0.5 - `broker_note_details.stock_exchange_fee` (number, required) The fee charged by the stock exchange for registry services. Example: 3 - `broker_note_details.clearing_custody_fee` (number, required) The fee charged by financial institutions for custody services. Example: 1.5 - `broker_note_details.taxes` (number, required) The total amount taxes charged on the transaction for the day, excluding income tax withheld at source. Example: 10 - `broker_note_details.income_tax` (number, required) The total amount of income tax withheld at the source for the day. Example: 5 - `broker_note_details.net_value` (number, required) The net value of the broker note after deducting expenses for brokerage fees, clearing settlement fees, registration fees, ANA fees, emoluments, custody fees, taxes, and IRRF Example: 980 ## Response 202 fields (application/json): - `request_id` (string) The unique ID for this request. We recommend you store this value to later identify which webhook event relates to an asynchronous request. Example: "b5d0106ac9cc43d5b36199fe831f6bbe" ## Response 403 fields (application/json): - `code` (string) A unique error code () that allows you to classify and handle the error programmatically. ℹ️ Check our DevPortal for more information on how to handle 403 access_to_resource_denied. Example: "access_to_resource_denied" - `message` (string) A short description of the error. For errors, the description is: - . Example: "You don't have access to this resource." - `request_id` (string) A 32-character unique ID of the request (matching a regex pattern of: ). Provide this ID when contacting the Belvo support team to accelerate investigations. Example: "9e7b283c6efa449c9c028a16b5c249fb" ## Response 404 fields (application/json): - `code` (string) A unique error code () that allows you to classify and handle the error programmatically. Example: "not_found" - `message` (string) A short description of the error. For errors, the description is: - Example: "Not found" - `request_id` (string) A 32-character unique ID of the request (matching a regex pattern of: ). Provide this ID when contacting the Belvo support team to accelerate investigations. Example: "9e7b283c6efa449c9c028a16b5c249fb" ## Response 408 fields (application/json): - `code` (string) A unique error code () that allows you to classify and handle the error programmatically. ℹ️ Check our DevPortal for more information on how to handle 408 request_timeout errors. Example: "request_timeout" - `message` (string) A short description of the error. For errors, the description is: - . Example: "The request timed out, you can retry asking for less data by changing your query parameters" - `request_id` (string) A 32-character unique ID of the request (matching a regex pattern of: ). Provide this ID when contacting the Belvo support team to accelerate investigations. Example: "9e7b283c6efa449c9c028a16b5c249fb" ## Response 500 fields (application/json): - `code` (string) A unique error code () that allows you to classify and handle the error programmatically. ℹ️ Check our DevPortal for more information on how to handle 500 unexpected_error errors. Example: "unexpected_error" - `message` (string) A short description of the error. For errors, the description is: - . Example: "Belvo is unable to process the request due to an internal system issue or to an unsupported response from an institution" - `request_id` (string) A 32-character unique ID of the request (matching a regex pattern of: ). Provide this ID when contacting the Belvo support team to accelerate investigations. Example: "9e7b283c6efa449c9c028a16b5c249fb"