--- title: "Get an investment's details" method: GET path: "/api/br/investments/{id}/" tags: ["Investments Brazil"] --- # Get an investment's details `GET /api/br/investments/{id}/` Get the details of a specific investment. ## Path parameters - `id` string, uuid, required ## Query parameters - `omit` string - `fields` string ## Response `200` Ok - InvestmentBrazil - `id` string, uuid — The unique identifier created by Belvo used to reference the current investment. - `type` string — The type of investment: Can be either - `FIXED_INCOME_BANKING` (*Renda Fixa Bancária*) - `FIXED_INCOME_CREDIT` (*Renda Fixa Crédito*) - `VARIABLE_INCOME` (*Renda Variável*) - `TREASURY_BOND` (*Tesouro Direto*) - `INVESTMENT_FUND` (*Fundos de Investimento*) - `issuer_id_number` string, nullable — The CNPJ number of the issuing institution. For Investment Funds, this is the CNPJ of the fund. > 🚧 Not applicable for `TREASURY_BOND` investments. - `isin_number` string, nullable — The ISO-6166 International Securities Identification Number (ISIN) for the financial instrument. - `currency` string — The three-letter currency code (ISO-4217) of the investment. For example, `BRL` for Brazilian Real. - `product_name` string — The name of the investment product. - For `FIXED_INCOME_BANKING`, this can be: CDB, RDB, LCI, or LCA. - For `FIXED_INCOME_CREDIT`, this can be: DEBENTURES, CRI, or CRA. - For `INVESTMENT_FUND`, this will be the name of the fund. For example: CONSTELLATION MASTER FIA - For `TREASURY_BOND`, this will be the name of the bond. For example: Tesouro Selic 2025. - For `VARIABLE_INCOME_INCOME`, this will be the name of the stock. For example AAPL. - `is_tax_exempt` boolean — Indicates if the investment is exempt from taxes. > 🚧 Only applicable for `FIXED_INCOME_CREDIT` investments. - `clearing_code` string, nullable — The clearing code of the investment. > 🚧 Only applicable for `FIXED_INCOME_BANKING` and `FIXED_INCOME_CREDIT`. - `due_date` string, date, nullable — The maturity date of the financial instrument. > 🚧 Only applicable for `FIXED_INCOME_BANKING`, `FIXED_INCOME_CREDIT`, and `TREASURY_BOND` investments. - `issue_date` string, date, nullable — The date the financial instrument was issued. > 🚧 Only applicable for `FIXED_INCOME_BANKING` and `FIXED_INCOME_CREDIT`. - `purchase_date` string, date, nullable — The date the financial instrument was purchased. > 🚧 Only applicable for `FIXED_INCOME_BANKING`, `FIXED_INCOME_CREDIT`, and `TREASURY_BOND` investments. - `grace_period_date` string, date, nullable — The grace period date of the financial instrument. > 🚧 Only applicable for `FIXED_INCOME_BANKING` and `FIXED_INCOME_CREDIT`. - `issue_unit_price` number, float, nullable — The unit price of the financial instrument at the time of issuance. > 🚧 Only applicable for `FIXED_INCOME_BANKING` and `FIXED_INCOME_CREDIT`. - `balance` InvestmentBalance — The balance of the investment instrument, as of the `reference_date`. - `reference_date` string, date-time — The date and time that the balance was calculated for the investment instrument, in `YYYY-MM-DDTHH:MM:SSZ` format. - `gross_value` number, float — The gross value of the investment instrument. - `blocked_amount` number, float — The amount of the investment instrument that is blocked or unavailable for transactions. - `quantity` number, float — The number of units, quotas, or assets held on the reference date. - `gross_unit_price` number, float, nullable — The current gross unit value of the investment on the reference date - `net_value` number, float, nullable — The net value of the investment after deductions for taxes, fees, and other charges, as of the reference date. - `withheld_amount` number, float, nullable — The amount of the investment instrument that has been withheld or deducted from the net value. - `transaction_fee` number, float, nullable — The fees and taxes charged for the transaction. - `purchase_unit_price` number, float, nullable — The unit price at the time of purchase for the security or asset. - `pre_fixed_rate` number, float, nullable — The pre-fixed remuneration rate for the income product. - `post_fixed_rate` number, float, nullable — The percentage of the post-fixed indexer for the income product. - `penalty_fee` number, float, nullable — The penalty (fine) for delays in payments, as defined in the contract. - `late_payment_fee` number, float, nullable — The interest charged for delayed payments. - `closing_price` number, float, nullable — The closing price of the investment on the reference date. - `unit_price_factor` number, float, nullable — The factor used to calculate the unit price. - `remuneration` Remuneration — The remuneration details of the investment instrument. - `pre_fixed_rate` number, float, nullable — The fixed interest rate defined at issuance, expressed as a decimal (for example `0.150000` represents 15%). - `post_fixed_rate` number, float, nullable — The post-fixed interest rate defined at issuance, expressed as a decimal (for example `0.150000` represents 15%). - `rate_type` string, nullable — The type of remuneration rate applied to the financial instrument. Can be either: - `LINEAR` - `EXPONENCIAL` - `rate_periodicity` string, nullable — The frequency that the remuneration rate is applied to the financial instrument. Can be either: - `DIARIO` - `MENSAL` - `ANUAL` - `SEMESTRAL` - `calculation_base` string, nullable — Indicates whether the remuneration or interest calculation is based on business days (*dias úteis*) or calendar days (*dias corridos*). - `DIAS_UTEIS` - `DIAS_CORRIDOS` - `indexer` string, nullable — The index used as a reference to calculate the profitability or returns of the financial instrument. Can be one either: - `CDI` - `DI` - `TR` - `IPCA` - `IGP_M` - `IGP_DI` - `INPC` - `BCP` - `TLC` - `SELIC` - `PRE_FIXADO` - `OUTROS` - `indexer_additional_info` string, nullable — Additional information regarding the `indexer` rate. Required when `indexer` is set to `OUTROS`. - `classification_details` ClassificationDetails, nullable — The classification details of the investment instrument. > 🚧 Only applicable for `INVESTMENT_FUND` investments. > > This object is only applicable for `INVESTMENT_FUND` investments. For all other investment types, this object will be `null`. - `category` string, nullable — The investment fund's category, as defined by ANBIMA's classification standards. Can be one of: - `RENDA_FIXA` - `ACOES` - `MULTIMERCADO` - `CAMBIAL` - `class` string, nullable — The class within the investment fund's category, as defined by ANBIMA's classification standards. - `subclass` string, nullable — The subclass of the investment fund, as defined by ANBIMA's classification standards. - `voucher_payment_details` VoucherPaymentDetails — The voucher payment (also known as coupon payments) details of the investment instrument. > 🚧 Only applicable for `FIXED_INCOME_CREDIT` and `TREASURY_BOND` investments. > > This object is only applicable for `FIXED_INCOME_CREDIT` and `TREASURY_BOND` investments. For all other investment types, this object will be `null`. - `is_voucher_payment` boolean — Indicates whether the financial instrument pays periodic interest (voucher payments). - `periodicity` string, nullable — The frequency that the voucher payments are made. Required when `is_voucher_payment` is set to `true`. Can be one of: - `MENSAL` - `TRIMESTRAL` - `SEMESTRAL` - `ANUAL` - `IRREGULAR` - `OUTROS` - `periodicity_additional_info` string, nullable — Additional information about the voucher payment periodicity. Required when `periodicity` is set to `OUTROS`. - `debtor_details` DebtorDetails, nullable — The debtor details of the investment instrument. > 🚧 Only applicable for `FIXED_INCOME_CREDIT` investments. > > This object is only applicable for `FIXED_INCOME_CREDIT` investments. For all other investment types, this object will be `null`. - `name` string — The name of the debtor. - `id_document_number` string — The debtor's identification document number (CNPJ). ## Other responses - `401` — Unauthorized - `403` — Access to Belvo API denied - `404` — Not Found Error - `408` — Request Timeout - `500` — Unexpected Error --- [API](https://skmtc.net/belvo/apis/belvo-api-docs.md) · [All operations](https://skmtc.net/belvo/apis/belvo-api-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/belvo/belvo-api-docs/versions/3423c786ece5/schema)