1. Currency Exchange
Partner API
  • Getting Started
    • Introduction
    • Authentication
    • Business Use Cases
  • API References
    • Partner Operations
      • Crypto Deposits
        • Get Crypto Deposit Details
      • Crypto Withdrawal
        • Get Crypto Withdrawal Details
      • Currency Exchange
        • Get Rates
          GET
        • Create Lock
          POST
        • Get Exchange Details
          GET
      • Balances & History
        • Get Balances
        • Get Balance History
      • SEPA Transfers
        • Get SEPA Deposit Info
        • Get SEPA Deposit Contact List
        • Create a SEPA Transfer
        • Get SEPA Transfer Details
  • Integration
    • SDKs & Integration Guides
    • Transaction Processing
    • Error Handling
    • Rate Limiting
    • Webhooks
      • User & KYC Webhooks
        • User Balance Generation Webhook
        • KYC File Added Webhook
        • POA Verification Status Webhook
        • KYC Verification Status Webhook
        • Create Wallet Webhook
        • High Risk KYC Verification Webhook
      • Transfers & Payments Webhooks
        • Internal Transfer Webhook
        • IBAN Status Webhook
        • Partner SEPA Transfer Webhook
        • User SEPA Transfer Webhook
        • SEPA Deposit Webhook
        • Crypto Withdrawal Webhook
        • Crypto Deposit Webhook
        • Exchange Webhook
        • Card Transaction Webhook
        • Order Status Webhook
        • Payment Link Webhook
      • Card Webhooks
        • Card 3DS Code Webhook
        • Card Activation Code Webhook
  • Reference
    • Supported Countries
    • Supported Currencies
    • Fees
    • FAQ
    • Changelog
    • Support
  1. Currency Exchange

Get Exchange Details

Testing Env
https://stage-api.fintegence.io
Testing Env
https://stage-api.fintegence.io
GET
/v1/exchange/details
Retrieves full details of a specific exchange transaction using either internal or external identifiers.
Use this endpoint to track the execution status, applied exchange rate, fees, and final amounts converted.

Query Parameters Validation#

To query exchange details, you must provide exactly one of the following identifiers in your request:
transactionId: internal platform transaction identifier (UUID), OR
externalId: partner-side unique identifier (UUID).
Required Identifier
Providing at least one parameter is required (transactionId or externalId). If neither is supplied, the request will fail validation.

Status Lifecycle#

Exchange operations transition through the following states:
started / pending: exchange received and execution is underway.
locked-to-processing: internal processing lock applied during balance conversion.
waiting-for-verification: awaiting compliance or risk checks.
successful: exchange completed; funds converted and credited.
unsuccessful / rejected-by-reviewer / banned: exchange failed or was declined.
Webhook Integration
For real-time status updates, subscribe to the exchange webhook events instead of polling this endpoint.

Request

Authorization
API Key
Add parameter in header
x-api-key
Example:
x-api-key: ********************
or
Query Params

Responses

🟱200Success
application/json
Bodyapplication/json

🟠401Access Denied
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://stage-api.fintegence.io/v1/exchange/details?transactionId=undefined&externalId=undefined' \
--header 'x-api-key: <api-key>'
Response Response Example
200 - Success
{
    "transactionId": "921a9579-f7d2-4c82-b470-ab6db7af1a32",
    "externalId": "fab0db22-1e57-4e7c-8f9a-6b084a24b4c7",
    "status": "successful",
    "sourceAmount": "10",
    "destinationAmount": "0.6056330404505998",
    "sourceCurrency": "DOGE",
    "destinationCurrency": "EUR",
    "rate": "0.06056330404505999",
    "fee": "10",
    "createdAt": "2026-09-10T11:11:59.845Z"
}
Previous
Create Lock
Next
Balances & History
Built with