Get FX Trade Details (Atlas)

Overview

The GET /banking/ibans/v2/fx/{reference} endpoint retrieves comprehensive details for a specific FX trade using its unique order reference (e.g. EN-01011900-001).

The returned record includes execution amounts, applied exchange rate, fee breakdowns, counterparty details, inward/outward settlement timestamps, SWIFT MT103 logs, and UETR tracking keys.

Resource Access

• HTTP Method: GET
• Endpoint: /banking/ibans/v2/fx/{reference}
• Authentication: Bearer token required

Request Headers

Header	Value	Required	Description
Authorization	Bearer {access_token}	Yes	JWT Bearer access token
Accept	application/json	Yes	Response payload format

Path Parameters

Parameter	Type	Required	Description
reference	string	Yes	The unique FX order or trade reference (e.g. EN-01011900-001).

Response

Success Response (200 OK)

{
  "id": "10492",
  "userId": 5820,
  "reference": "EN-01011900-001",
  "currencyFrom": "USD",
  "amountFrom": 5000.00,
  "currencyTo": "GBP",
  "amountTo": 3927.00,
  "rate": 0.7854,
  "state": "confirmed",
  "source": "wallet",
  "sourceId": 101,
  "target": "account",
  "targetId": 948201,
  "inwardSettlementTime": "2026-09-16T02:00:05.000Z",
  "outwardSettlementTime": "2026-09-16T02:00:15.000Z",
  "createdAt": "2026-09-16T02:00:00.000Z",
  "tracking": {
    "uetr": "dd60300f-25e6-4fb3-bb87-36ceb02844f2",
    "mt103": ":71A:OUR\n:72:TRADE SETTLEMENT"
  },
  "transaction": {
    "receiver": {
      "name": "Acme Global Logistics Ltd",
      "accountNumber": "20406080",
      "bankName": "Barclays Bank UK",
      "bankCode": "200000"
    }
  }
}

Response Fields

Field	Type	Description
reference	string	Unique identifier of the FX transaction.
state	string	Current lifecycle state (confirmed, inwardSettlementDone, outwardSettlementDone, archived).
rate	number	Applied exchange rate.
inwardSettlementTime	string	Timestamp when funding was settled.
outwardSettlementTime	string	Timestamp when payout leg was dispatched.
tracking.uetr	string	Unique End-to-End Transaction Reference.

Code Examples

cURL

curl -X GET "https://gateway.ahrvo.network/banking/ibans/v2/fx/EN-01011900-001" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Accept: application/json"

Python

import requests

url = "https://gateway.ahrvo.network/banking/ibans/v2/fx/EN-01011900-001"
headers = {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Accept": "application/json"
}

response = requests.get(url, headers=headers)
print("Trade Details:", response.json())

JavaScript (Node.js)

const axios = require('axios');

const url = 'https://gateway.ahrvo.network/banking/ibans/v2/fx/EN-01011900-001';
const headers = {
  'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
  'Accept': 'application/json'
};

axios.get(url, { headers })
  .then(res => console.log('Trade State:', res.data.state))
  .catch(err => console.error(err.response ? err.response.data : err.message));

Interactive API Explorer