---
title: "List investments"
method: GET
path: "/api/br/investments/"
tags: ["Investments Brazil"]
---

# List investments

`GET /api/br/investments/`

## ▶️ Usage

With the List Investments method, you can:

1. **[Required]** List investments related to a specific `link.id` (using the `link` query parameter).
2. Get the details of a specific `investment.id` (using the `id` query parameter).

## 📖 Pagination

This method returns a paginated response (default: 100 items per page). You can use the `page_size` query parameter to increase the number of items returned to a maximum of 1000 items. You can use the `page` query parameter to navigate through the results. For more details on how to navigate Belvo's paginated responses, see our <a href="https://developers.belvo.com/docs/belvo-pagination-tips" target="_blank">Pagination Tips</a> article.

## 🔦 Filtering Responses

Please see the query list below for a list of fields that you can filter your responses by. For more information on how to use filters, see our <a href="https://developers.belvo.com/docs/searching-and-filtering" target="_blank">Filtering responses</a> article.

## Query parameters

- `link` string, uuid, required
- `page_size` integer
- `page` integer
- `id` string, uuid
- `id__in` string[]
- `link__in` string[]
- `omit` string
- `fields` string
- `type` string
- `type__in` string[]
- `created_at` string, date
- `created_at__gt` string, date
- `created_at__gte` string, date
- `created_at__lt` string, date
- `created_at__lte` string, date
- `created_at__range` string[]

## Response `200`

Ok

- object
  - `count` integer — The total number of results in your Belvo account.
  - `next` string, uri, nullable — The URL to next page of results. Each page consists of up to 100 items. If there are not enough results for an additional page, the value is `null`. In our documentation example, we use `{endpoint}` as a placeholder value. In production, this value will be replaced by the actual endpoint you are currently using (for example, `accounts` or `owners`).
  - `previous` string, uri, nullable — The URL to the previous page of results. If there is no previous page, the value is `null`.
  - `results` InvestmentBrazil[] — Array of investment objects.
    - `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/revisions/e82dca4a4b97/schema)