---
title: "Retrieve FX details"
method: POST
path: "/api/service/fx/retrieve"
tags: ["FX"]
---

# Retrieve FX details

`POST /api/service/fx/retrieve`

Retrieve the details of a past fx transfer using the fxId.

## Request body

- RetrieveFxDetailsDto
  - `fxId` string, uuid, required — The fxId attached to the transfer.

## Response `200`

FX details retrieved successfully

- RetrieveFxDetailsResponseDto
  - `id` string, required — The fxId attached to the transfer.
  - `rate` string, required — The exchange rate for the given currency pair.
  - `targetAmount` string — The amount of the target currency for the given source amount.
  - `sourceAmount` string — The amount of source currency to convert.
  - `sourceCurrency` 'EUR' | 'GBP' | 'USDC', required — The source currency code
  - `targetCurrency` 'EUR' | 'GBP' | 'USDC', required — The target currency code
  - `metadata` object — Additional metadata.
  - `status` 'initiated' | 'succeeded' | 'failed', required — The status of the FX transaction.

## Changes

> 48 revisions in range; 2 could not be searched.

- **2025-12-08** `59707ad8c8bb` — 1 breaking
  - the `fxId` request property type/format changed from `string`/`` to `string`/`uuid`
- **2025-11-11** `7a1403d578a6` — 2 warning, 2 info
  - added the new `initiated` enum value to the `status` response property for the response status `200`
  - added the new `succeeded` enum value to the `status` response property for the response status `200`
  - removed the `processing` enum value from the `status` response property for the response status `200`
  - removed the `success` enum value from the `status` response property for the response status `200`

[Change history](https://skmtc.dev/augustus/apis/ivy-api/changes/api/service/fx/retrieve/post.md)

---

[API](https://skmtc.dev/augustus/apis/ivy-api.md) · [All operations](https://skmtc.dev/augustus/apis/ivy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/augustus/ivy-api/revisions/c3055fc06ca3/schema)