---
title: "List exchange history for a specific exchange"
method: GET
path: "/api/br/exchanges/{id}/history/"
tags: ["Exchanges"]
---

# List exchange history for a specific exchange

`GET /api/br/exchanges/{id}/history/`

{% 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 %}

Get the modification history (audit trail) for a specific exchange operation.

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

## Path parameters

- `id` string, uuid, required

## Query parameters

- `page_size` integer
- `page` integer
- `omit` string
- `fields` string

## Response `200`

OK - Exchange History 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` ExchangeHistory[] — An array of exchange history 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.
    - `exchange_id` string, uuid, required — The Belvo-generated unique identifier for the original exchange operation.
    - `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.
    - `event_sequence_number` string, required — The sequence number of the event record at the Central Bank (Bacen).
    - `event_type` 1 | 2 | 3 | 4 | 5 | 6 | 9, required — The type of event that occurred for the exchange operation. We return one of the following enum values: - `1` - Contract in the primary market - `2` - Modification of exchange operation in the primary market - `3` - Cancellation of exchange operation in the primary market - `4` - Settlement of exchange operation in the primary market - `5` - Write-off of outstanding amount to be settled in the primary market - `6` - Reinstatement of written-off outstanding amount in the primary market - `9` - Nullification of exchange operation in the primary market (used, for example, in the nullification of a settlement/cancellation event) > **Note**: Codes follow the messaging layout sent by institutions to the Central Bank of Brazil.
    - `event_created_at` string, date-time, required — The ISO-8601 timestamp when the event occurred.
    - `operation_due_date` string, date, nullable — The date when the operation (buy or sell), after the event, is scheduled to be settled, in `YYYY-MM-DD` format.
    - `local_operation_tax_amount` number, float, nullable — The exchange rate applied to the operation after the event.
    - `local_operation_tax_currency` string, nullable — The three-letter currency code (ISO-4217) for the exchange rate.
    - `local_operation_value_amount` number, float, nullable — The total value of the operation in local currency after the event.
    - `local_operation_value_currency` string, nullable — The three-letter currency code (ISO-4217) for the local currency.
    - `foreign_operation_value_amount` number, float, nullable — The total value of the operation in foreign currency after the event.
    - `foreign_operation_value_currency` string, nullable — 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 foreign currency after the event. This field is mandatory for events created (`event_created_at`) from April 15, 2024 onwards, in cases of exchange operations with future settlement.
    - `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 after the event. This field is required for spot exchange operations that reach up to the limit of $100,000 USD or equivalent in other currencies.
    - `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 after the event. This field is mandatory in cases of exchange operations with future settlement.
    - `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 — 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, nullable — 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.
    - `foreign_partie_relationship_code` string, nullable — The code indicating the relationship between the customer and the foreign payer/receiver. This code must comply with the relationship codes referenced in Resolution 277 or Circular 3690, as applicable to the exchange contract. > **Note**: This field is optional when: > - The `settlement_method` field is `ESPECIE_CHEQUES_VIAGEM` or `CARTAO_PREPAGO`. > - The `event_type` field is different from `4` (Settlement of exchange operation in the primary market). > > If the institution has this information, it is mandatory to send it. If the information is updated after contracting, it must be sent through events.
    - `foreign_partie_name` string, nullable — The name of the foreign payer or receiver. > **Note**: This field is optional when: > - The `settlement_method` field is `ESPECIE_CHEQUES_VIAGEM` or `CARTAO_PREPAGO`. > - The `event_type` field is different from `4` (Settlement of exchange operation in the primary market). > > If the institution has this information, it is mandatory to send it. If the information is updated after contracting, it must be sent through events.
    - `foreign_partie_country_code` string, nullable — The country code of the foreign payer or receiver, following the ISO 3166-1 standard. > **Note**: This field is optional when: > - The `settlement_method` field is `ESPECIE_CHEQUES_VIAGEM` or `CARTAO_PREPAGO`. > - The `event_type` field is different from `4` (Settlement of exchange operation in the primary market). > > If the institution has this information, it is mandatory to send it. If the information is updated after contracting, it must be sent through events.

## 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)