---
title: "List exchanges"
method: GET
path: "/api/br/exchanges/"
tags: ["Exchanges"]
---

# List exchanges

`GET /api/br/exchanges/`

{% admonition type="warning" name="Coming Soon" %}
  This endpoint is currently undergoing development. As such, minor changes or bugs may occur. If you encounter any issues, please contact your Belvo representative.
{% /admonition %}

## ▶️ Usage

With the List Exchanges method, you can:
  
  1. **[Required]** List exchanges related to a specific `link.id` (using the `link` query parameter).
  2. Get the details of a specific `exchange.id` (using the `id` query parameter).

## 🔦 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.

## 📖 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.

## Query parameters

- `link` string, uuid, required
- `id` string, uuid
- `link__in` string[]
- `id__in` string[]
- `page_size` integer
- `page` integer
- `omit` string
- `fields` string
- `collected_at` string, date
- `collected_at__gt` string, date
- `collected_at__gte` string, date
- `collected_at__lt` string, date
- `collected_at__lte` string, date
- `collected_at__range` 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 - Exchanges Retrieved

- 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` Exchange[] — An array of exchange objects.
    - `id` string, uuid, required — Belvo's unique identifier for the current item.
    - `link` string, uuid, nullable, required — The `link.id` the data belongs to.
    - `created_at` string, date-time, required — The ISO-8601 timestamp of when the data point was created in Belvo's database.
    - `collected_at` string, date-time, required — The ISO-8601 timestamp when the data point was collected.
    - `operation_identifier` string, required — The network's unique identifier for the exchange operation.
    - `operation_number` string, nullable — The 12-digit operation registration number from the Brazil Central Bank (Bacen). This can be `null` if the operation has not yet been registered.
    - `operation_type` 'COMPRA' | 'VENDA', required — The type of exchange operation. We return one of the following enum values: - `COMPRA` - Buy (client is buying foreign currency) - `VENDA` - Sell (client is selling foreign currency)
    - `operation_requested_at` string, date-time, required — The ISO-8601 timestamp when the exchange operation was contracted.
    - `authorized_institution_identifier` integer, required — The CNPJ of the institution authorized to conduct the operation.
    - `authorized_institution_name` string, required — The name of the authorized institution.
    - `intermediary_institution_identifier` integer, nullable — The CNPJ of the intermediary institution, if one was used.
    - `intermediary_institution_name` string, nullable — The name of the intermediary institution. Must be present if `intermediary_institution_identifier` is available.
    - `operation_due_date` string, date, required — The currently scheduled settlement date for the operation, in `YYYY-MM-DD` format. > **Note**: This field is updated if any changes are made to the exchange operation.
    - `local_operation_tax_amount` number, float, required — The exchange rate applied to the operation.
    - `local_operation_tax_currency` string, required — The three-letter currency code (ISO-4217) for the exchange rate.
    - `local_operation_value_amount` number, float, required — The total value of the operation in local currency.
    - `local_operation_value_currency` string, required — The three-letter currency code (ISO-4217) for the local currency.
    - `foreign_operation_value_amount` number, float, required — The total value of the operation in the foreign currency.
    - `foreign_operation_value_currency` string, required — The three-letter currency code (ISO-4217) for the foreign currency.
    - `operation_outstanding_balance_amount` number, float, nullable — The outstanding balance to be settled, in the foreign currency. In the case that the exchange operation is scheduled to be settled within two days of the `operation_requested_at`, this value can be `null`.
    - `operation_outstanding_balance_currency` string, nullable — The currency of the outstanding balance. Required if `operation_outstanding_balance_amount` is not `null`.
    - `tev_amount_amount` number, float, nullable — The "All-in Rate" (Valor Efetivo Total/Total Effective Cost), representing the total cost of the operation. Required when the operation is scheduled to be settled within two days of the `operation_requested_at` and does not exceed $100,000 USD.
    - `tev_amount_currency` string, nullable — The currency of the VET (always BRL). Required if `tev_amount_amount` is not `null`.
    - `local_currency_advance_percentage` number, float, nullable — The percentage of the foreign currency value that was granted to the client in advance. In the case that the exchange operation is scheduled to be settled within two days of the `operation_requested_at`, this value can be `null`.
    - `settlement_method` 'CONTA_DEPOSITO_MOEDA_ESTRANGEIRA_PAIS' | 'CONTA_DEPOSITO_OU_PAGAMENTO_EXPORTADOR_INSTITUICAO_EXTERIOR' | 'ESPECIE_CHEQUES_VIAGEM' | 'CARTAO_PREPAGO' | 'TELETRANSMISSAO' | 'SEM_MOVIMENTACAO_VALORES' | 'DEMAIS' | 'CARTA_CREDITO_A_VISTA' | 'CARTA_CREDITO_A_PRAZO' | 'CONTA_DEPOSITO' | 'CHEQUE' | 'TITULOS_VALORES' | 'SIMBOLICA' | 'CONTA_DEPOSITO_EXPORTADOR_MANTIDA_NO_EXTERIOR' | 'CONVENIO_PAGAMENTOS_E_CREDITOS_RECIPROCOS' | 'OUTRO_NAO_MAPEADO_OFB' | 'null', nullable, required — The method of delivery for the foreign currency. We return one of the following enum values: - `CARTA_CREDITO_A_VISTA` (Code 10) - Sight letter of credit - `CARTA_CREDITO_A_PRAZO` (Code 15) - Term letter of credit - `CONTA_DEPOSITO` (Code 20) - Deposit account - `CONTA_DEPOSITO_MOEDA_ESTRANGEIRA_PAIS` (Code 21) - Foreign currency deposit account in country - `CONTA_DEPOSITO_EXPORTADOR_MANTIDA_NO_EXTERIOR` (Code 22) - Exporter's deposit account maintained abroad - `CONTA_DEPOSITO_OU_PAGAMENTO_EXPORTADOR_INSTITUICAO_EXTERIOR` (Code 23) - Deposit account or payment to exporter at foreign institution - `CONVENIO_PAGAMENTOS_E_CREDITOS_RECIPROCOS` (Code 25) - Reciprocal payments and credits agreement - `CHEQUE` (Code 30) - Check - `ESPECIE_CHEQUES_VIAGEM` (Code 50) - Cash or traveler's checks - `CARTAO_PREPAGO` (Code 55) - Prepaid card - `TELETRANSMISSAO` (Code 65) - Wire transfer - `TITULOS_VALORES` (Code 75) - Securities/bonds - `SIMBOLICA` (Code 90) - Symbolic - `SEM_MOVIMENTACAO_VALORES` (Code 91) - No movement of funds - `DEMAIS` (Code 99) - Others - `OUTRO_NAO_MAPEADO_OFB` - Other not mapped by Open Finance Brazil - `null`
    - `operation_category_code` string, required — The 5-digit Central Bank code that classifies the "nature" of the operation. This code must comply with the nature codes referenced in Resolution 277 or Circular 3690, as applicable to the exchange contract.

## Other responses

- `401` — Unauthorized
- `403` — Access to Belvo API denied
- `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/3423c786ece5/schema)