Sign in

v1

latestOpenAPI 3.0.22026-08-061464031.4 MB
Exchanges

List exchange history for a specific exchange

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

get/api/br/exchanges/{id}/history/

Path parameters

idstring uuid required

The exchange.id you want to get the history for.

Query parameters

page_sizeinteger
Example:100

Indicates how many results to return per page. By default we return 100 results per page.

ℹ️ The minimum number of results returned per page is 1 and the maximum is 1000. If you enter a value greater than 1000, our API will default to the maximum value (1000).

pageinteger
Example:1

A page number within the paginated result set.

omitstring

Omit certain fields from being returned in the response. For more information, see our <a href="https://developers.belvo.com/docs/searching-and-filtering" target="_blank">Filtering responses</a> DevPortal article.

fieldsstring

Return only the specified fields in the response. For more information, see our <a href="https://developers.belvo.com/docs/searching-and-filtering" target="_blank">Filtering responses</a> DevPortal article.

Response

OK - Exchange History Retrieved

countinteger

The total number of results in your Belvo account.

nextstring 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).

previousstring uri nullable

The URL to the previous page of results. If there is no previous page, the value is null.

Example response

{
  "count": 130,
  "next": "https://sandbox.belvo.com/api/{endpoint}/?link=1bd948f7-245d-4313-b604-34d1044cb908page=2",
  "results": [
    {
      "id": "0d3ffb69-f83b-456e-ad8e-208d0998d71d",
      "link": "30cb4806-6e00-48a4-91c9-ca55968576c8",
      "exchange_id": "c4bfecf9-4eb6-4920-9f9f-e1f1e60ef321",
      "created_at": "2022-02-09T08:45:50.406032Z",
      "collected_at": "2022-02-09T08:45:50.406032Z",
      "operation_identifier": "92792126019929240",
      "event_sequence_number": "493874649457",
      "event_type": 2,
      "event_created_at": "2023-03-10T14:00:00Z",
      "operation_due_date": "2023-03-20",
      "local_operation_tax_amount": 1.4,
      "local_operation_tax_currency": "BRL",
      "local_operation_value_amount": 950,
      "local_operation_value_currency": "BRL",
      "foreign_operation_value_amount": 678.57,
      "foreign_operation_value_currency": "USD",
      "operation_outstanding_balance_amount": 678.57,
      "operation_outstanding_balance_currency": "USD",
      "tev_amount_amount": 1002,
      "tev_amount_currency": "BRL",
      "local_currency_advance_percentage": 0.12,
      "settlement_method": "CARTA_CREDITO_A_PRAZO",
      "operation_category_code": "90302",
      "foreign_partie_relationship_code": "50",
      "foreign_partie_name": "Global Tech Imports LLC",
      "foreign_partie_country_code": "US"
    }
  ]
}