> ## Documentation Index > Fetch the complete documentation index at: https://doc.engagexpay.com/llms.txt > Use this file to discover all available pages before exploring further. # Fetch Transaction Details V3 > Returns one transaction with its fiat or crypto details, fee breakdown, batch linkage and, for on-ramps, the depositor (the party that sent the fiat). A transaction is only visible to the client that owns the customer it belongs to. > [!NOTE] > > Any fiat transactions submitted between 9:30 AM and 5:30 PM ET on a weekday are processed the same day. Transactions submitted outside these hours or on weekends will be settled the next business day. ## What changed from V2 V3 adds the `depositor` object to the response. Everything else is identical to [Fetch Transaction Details V2](https://doc.engagexpay.com/api-reference/transactions/fetch-transaction-details-v2.md). No `X-Idempotency-Key` is needed. ## The `depositor` object Who sent the fiat for an on-ramp, as reported by the receiving bank. It is null for every other transaction type, for on-ramps where the banking partner did not report a sender, and for on-ramps created before this field existed. Every field is nullable. Which fields are present depends on how the money arrived: | Field | Wire (Fedwire / SWIFT) | ACH international (IAT) | ACH domestic | | - | - | - | - | | `name` | yes | yes | yes | | `account_number` | yes | no, ACH does not carry the sender's account | no | | `bank_name` | when the bank message includes it | yes | no | | `contact` | rarely, phone and/or email as free text when the bank message includes it | no | no | | `address` | yes | yes | no | | `rail` | `FEDWIRE` or `SWIFT` | `ACH` | `ACH` | | `reference` | the sender's memo line | memo plus any remittance text | memo plus any remittance text | | `bank_reference` | IMAD | ACH trace number | ACH trace number | | `received_at` | when the bank posted the payment | same | same | > [!NOTE] > > Treat `account_number` and `contact` as optional in your integration: they are absent for all ACH payments, and `contact` is absent for almost all wires. ### Example: wire on-ramp ```json theme={null} "depositor": { "name": "M A HOLDINGS LIMITED", "account_number": "MU57WPBL3301111031300102002USD", "bank_name": null, "contact": null, "address": "117 ARCH MAKARIOU III AV, 4 FLOOR OFFICE 402,3021 LIMASSOL, CYPRUS", "rail": "SWIFT", "reference": "LOAN AGREEMENT", "bank_reference": "20261021B1Q8383C010186", "received_at": "2026-10-21T16:11:25Z" } ``` ## Status values | `status` | Meaning | | - | - | | `INITIATED` | Transaction created, funds not yet received. | | `FUNDS_RECEIVED` | Fiat (on-ramp) or crypto (off-ramp) has arrived. | | `IN_COMPLIANCE` | Under compliance review. | | `PROCESSING` | Payout submitted or in progress. | | `COMPLETED` | Settled. | | `FAILED` | Terminal failure; see `reason`. | | `REFUNDED` | Funds returned to the sender. | ## OpenAPI ````yaml GET /v3/transactions/{transaction_id} openapi: 3.1.0 info: title: EngageXPay API version: 1.0.0 description: >- A simple API specification for EngageXPay, a financial services platform that provides a range of banking and payment solutions for businesses and individuals. This API allows developers to integrate EngageXPay's services into their applications, enabling functionalities such as customer management, transaction processing, and access to financial data. servers: - url: https://sandbox.api.engagexpay.com description: Sandbox server - url: https://api.engagexpay.com description: Production server security: [] tags: - name: Authentication description: A modified OAuth 2.0 Client Credential Flow - name: Customers description: Customer management and document upload operations - name: Balances description: Retrieve wallet balance information - name: Catalogue description: | A set of endpoints to retrieve contextual data to assemble requests to EngageXPay's API - name: Beneficiaries description: Manage beneficiary accounts for payments and transfers - name: Transactions description: Transaction history and management for beneficiaries - name: Virtual Accounts description: Create and manage virtual accounts for USD to USDC conversions - name: Fees & FX Rates description: Retrieve fees and foreign exchange rates paths: /v3/transactions/{transaction_id}: get: tags: - Transactions summary: Fetch Transaction Details V3 description: >- Returns one transaction with its fiat or crypto details, fee breakdown, batch linkage and, for on-ramps, the depositor (the party that sent the fiat). A transaction is only visible to the client that owns the customer it belongs to. operationId: getTransactionByIdV3 parameters: - name: transaction_id in: path required: true description: >- The transaction id returned when the transaction was created or listed. schema: type: string format: uuid example: 6b2f1d7e-8c4a-4f3e-9a1b-2c3d4e5f6a7b responses: '200': description: Transaction details retrieved successfully content: application/json: schema: type: object required: - data properties: data: type: object properties: id: type: string format: uuid description: Transaction id. example: 6b2f1d7e-8c4a-4f3e-9a1b-2c3d4e5f6a7b transaction_type: type: string enum: - ONRAMP - OFFRAMP - CRYPTO_DEPOSIT - CRYPTO_WITHDRAWAL example: ONRAMP customer_id: type: string format: uuid description: Customer the transaction belongs to. example: 9f8e7d6c-5b4a-4c3d-8e2f-1a2b3c4d5e6f beneficiary_id: type: string format: uuid nullable: true description: >- Beneficiary for off-ramps and crypto withdrawals. Null for on-ramps and deposits. example: null hash: type: string nullable: true description: >- On-chain transaction hash once the crypto leg has been broadcast. example: >- 0x9c1e2b4d6f8a0c2e4b6d8f0a2c4e6b8d0f2a4c6e8b0d2f4a6c8e0b2d4f6ae4a2 status: type: string enum: - INITIATED - FUNDS_RECEIVED - IN_COMPLIANCE - PROCESSING - COMPLETED - FAILED - REFUNDED description: >- Transaction status. See the status table on this page for the meaning of each value. example: COMPLETED reason: type: string nullable: true description: >- Human-readable reason for a FAILED or REFUNDED transaction. example: null virtual_account_id: type: string format: uuid nullable: true description: >- Virtual account that received the fiat. On-ramps funded through a virtual account only. example: 3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9 pay_in_id: type: string format: uuid nullable: true description: >- Pay-in request that funded the on-ramp. Pay-in on-ramps only. example: null created_at: type: string format: date-time description: When the transaction was created. example: '2026-10-07T08:05:12.114Z' updated_at: type: string format: date-time description: Last status change. example: '2026-10-07T08:09:41.902Z' batch_info: type: object nullable: true description: Set when the transaction was created through a batch. properties: batch_id: type: string format: uuid batch_item_id: type: string format: uuid example: null fiat_details: type: object description: >- Populated for ONRAMP and OFFRAMP. Inner fields are null for crypto transactions. properties: source_amount: type: number nullable: true description: Amount sent. For an on-ramp, the fiat received. example: 70 source_currency: type: string nullable: true description: ISO 4217 code, for example USD. example: USD destination_amount: type: number nullable: true description: >- Amount paid out. For an on-ramp, the crypto sent to the customer wallet. example: 69.3 destination_currency: type: string nullable: true description: Destination currency or token, for example USDC. example: USDC fx_rate: type: number nullable: true description: Rate applied between source and destination. example: 1 tracking_info: type: object nullable: true description: >- Wire tracking references when available. Each field is a string or null. properties: imad: type: string nullable: true omad: type: string nullable: true uetr: type: string nullable: true example: null crypto_details: type: object description: >- Populated for CRYPTO_DEPOSIT and CRYPTO_WITHDRAWAL. Inner fields are null for fiat transactions, except tx_hash. properties: source_amount: type: number nullable: true description: >- Amount on the sending side. For a withdrawal this is the customer wallet; for a deposit, the external counterparty. example: null source_currency: type: string nullable: true example: null source_rail: type: string nullable: true example: null source_address: type: string nullable: true example: null destination_amount: type: number nullable: true description: Amount on the receiving side. example: null destination_currency: type: string nullable: true example: null destination_rail: type: string nullable: true example: null destination_address: type: string nullable: true example: null tx_hash: type: string nullable: true description: On-chain hash. example: >- 0x9c1e2b4d6f8a0c2e4b6d8f0a2c4e6b8d0f2a4c6e8b0d2f4a6c8e0b2d4f6ae4a2 fees: type: object description: Always present. Amounts in major units. properties: developer_fee: type: object properties: fixed: type: number description: Fixed developer fee applied. example: 0 percentage: type: number description: >- Percentage-based developer fee, already computed as an amount. example: 0.7 total_developer_fee: type: number description: Sum of the fixed and percentage developer fees. example: 0.7 network_fee: type: number description: Blockchain network fee. example: 0 conversion_fee: type: number description: Conversion fee. example: 0 platform_fee: type: number description: Platform fee. example: 0 total_fee: type: number description: Total fee deducted. example: 0.7 depositor: type: object nullable: true description: >- New in V3. The sender of the fiat for an ONRAMP, as reported by the receiving bank. Null for every other type, for on-ramps where the banking partner did not report a sender, and for on-ramps created before this field existed. Every field is nullable; see the depositor table on this page for which fields each rail carries. properties: name: type: string nullable: true description: Depositor name as reported by the sending bank. example: DEEPYTICS LTD account_number: type: string nullable: true description: >- Sender account number. Wires only; ACH does not carry the sender's account. example: null bank_name: type: string nullable: true description: >- Sending bank name when the bank message includes it. example: JPMorgan Chase contact: type: string nullable: true description: >- Phone and/or email as free text when the bank message includes it. Rare, wires only. example: null address: type: string nullable: true description: >- Depositor address when the bank message includes it. example: >- 161994 York House Green Lane West, Preston, GB, PR3 1NJ rail: type: string nullable: true enum: - FEDWIRE - SWIFT - ACH description: Rail the fiat arrived on. example: ACH reference: type: string nullable: true description: The sender's memo line plus any remittance text. example: ACH Credit 021000028004799 DEEPYTICS LTD WISE bank_reference: type: string nullable: true description: IMAD for wires, ACH trace number for ACH. example: '021000028004799' received_at: type: string format: date-time nullable: true description: When the bank posted the payment. example: '2026-10-07T08:00:08Z' examples: Onramp: summary: Onramp transaction with depositor value: data: id: 6b2f1d7e-8c4a-4f3e-9a1b-2c3d4e5f6a7b transaction_type: ONRAMP customer_id: 9f8e7d6c-5b4a-4c3d-8e2f-1a2b3c4d5e6f beneficiary_id: null hash: >- 0x9c1e2b4d6f8a0c2e4b6d8f0a2c4e6b8d0f2a4c6e8b0d2f4a6c8e0b2d4f6ae4a2 status: COMPLETED reason: null virtual_account_id: 3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9 pay_in_id: null created_at: '2026-10-07T08:05:12.114Z' updated_at: '2026-10-07T08:09:41.902Z' batch_info: null fiat_details: source_amount: 70 source_currency: USD destination_amount: 69.3 destination_currency: USDC fx_rate: 1 tracking_info: null crypto_details: source_amount: null source_currency: null source_rail: null source_address: null destination_amount: null destination_currency: null destination_rail: null destination_address: null tx_hash: >- 0x9c1e2b4d6f8a0c2e4b6d8f0a2c4e6b8d0f2a4c6e8b0d2f4a6c8e0b2d4f6ae4a2 fees: developer_fee: fixed: 0 percentage: 0.7 total_developer_fee: 0.7 network_fee: 0 conversion_fee: 0 platform_fee: 0 total_fee: 0.7 depositor: name: DEEPYTICS LTD account_number: null bank_name: JPMorgan Chase contact: null address: >- 161994 York House Green Lane West, Preston, GB, PR3 1NJ rail: ACH reference: ACH Credit 021000028004799 DEEPYTICS LTD WISE bank_reference: '021000028004799' received_at: '2026-10-07T08:00:08Z' Offramp: summary: Offramp transaction value: data: id: 4835aa27-3c8d-4a68-b4c8-331ade5bb496 transaction_type: OFFRAMP customer_id: 1a8e3bdc-05c9-4486-bdef-93464d24c9af beneficiary_id: 8d7f5ac6-0188-47c9-83f2-36a4aca7b472 hash: null status: COMPLETED reason: null virtual_account_id: null pay_in_id: null created_at: '2026-04-25T20:40:08.235667Z' updated_at: '2026-04-25T20:42:52.072478Z' batch_info: batch_id: c54b8cd6-efb4-4e36-92f0-2d289eefea52 batch_item_id: 32cf1b58-d026-494b-b6c6-d1e0af78060c fiat_details: source_amount: 5 source_currency: USD destination_amount: 526.48 destination_currency: BDT fx_rate: 117.19 tracking_info: null crypto_details: source_amount: null source_currency: null source_rail: null source_address: null destination_amount: null destination_currency: null destination_rail: null destination_address: null tx_hash: null fees: developer_fee: fixed: 0.5 percentage: 0 total_developer_fee: 0.51 network_fee: 0 conversion_fee: 0 platform_fee: 0 total_fee: 0.51 depositor: null Crypto deposit: summary: Crypto deposit transaction value: data: id: 11e9dea6-7891-43dd-a582-281394edd288 transaction_type: CRYPTO_DEPOSIT customer_id: 1a8e3bdc-05c9-4486-bdef-93464d24c9af beneficiary_id: null hash: >- 31NgS1hCLaH6sitUSFRbXDF9tPhMrA5nqSNSSvvLPFRrScwDdDRUnE8FV8mLgxdx7TDhxdk7chKNhc1gbeFRNkAf status: COMPLETED reason: null virtual_account_id: null pay_in_id: null created_at: '2026-04-25T19:12:07.804074Z' updated_at: '2026-04-25T19:12:07.804074Z' batch_info: null fiat_details: source_amount: null source_currency: null destination_amount: null destination_currency: null fx_rate: null tracking_info: null crypto_details: source_amount: 15 source_currency: USDC source_rail: SOLANA source_address: FEAp246mLPgWGVa12KG99GcRuptuCF3uTADp95pcy2cr destination_amount: 15 destination_currency: USDC destination_rail: SOLANA destination_address: BCSZEokfpVsSpUuuZJMScLiUpYjvvUmrrAJkNbrTTnng tx_hash: >- 31NgS1hCLaH6sitUSFRbXDF9tPhMrA5nqSNSSvvLPFRrScwDdDRUnE8FV8mLgxdx7TDhxdk7chKNhc1gbeFRNkAf fees: developer_fee: fixed: 0 percentage: 0 total_developer_fee: 0 network_fee: 0 conversion_fee: 0 platform_fee: 0 total_fee: 0 depositor: null Crypto withdrawal: summary: Crypto withdrawal transaction value: data: id: 8c92e9dd-6456-4aee-a441-1861144f1d8b transaction_type: CRYPTO_WITHDRAWAL customer_id: 1a8e3bdc-05c9-4486-bdef-93464d24c9af beneficiary_id: 6af8d598-36a5-477d-9320-d7c5ba309107 hash: >- 0xd2a3d65ce04c24c7af2b4ab86ac8c3ca525d010c600733bb062be74ee3899ec9 status: COMPLETED reason: null virtual_account_id: null pay_in_id: null created_at: '2026-04-29T09:56:14.906031Z' updated_at: '2026-04-29T09:56:58.631047Z' batch_info: null fiat_details: source_amount: null source_currency: null destination_amount: null destination_currency: null fx_rate: null tracking_info: null crypto_details: source_amount: 5 source_currency: USDC source_rail: POLYGON source_address: '0xc42a5f7083c7e8f1d9820c7660867277289cd998' destination_amount: 4.98535 destination_currency: USDC destination_rail: POLYGON destination_address: '0xD2Ba7d0DaBd36498df5906fC7B054Fa9EfA9843E' tx_hash: >- 0xd2a3d65ce04c24c7af2b4ab86ac8c3ca525d010c600733bb062be74ee3899ec9 fees: developer_fee: fixed: 0.01 percentage: 0.0005 total_developer_fee: 0.0105 network_fee: 0.004149 conversion_fee: 0 platform_fee: 0 total_fee: 0.014649 depositor: null '401': $ref: '#/components/responses/AuthenticationError' '403': description: The transaction belongs to another client content: application/json: schema: type: object properties: message: type: string example: You are not authorized to access this transaction. '404': $ref: '#/components/responses/NotFoundError' '422': $ref: '#/components/responses/ValidationError' '500': description: Unexpected server error content: application/json: schema: type: object properties: message: type: string example: Something went wrong! security: - bearerAuth: [] components: responses: AuthenticationError: description: Authentication failed due to invalid credentials content: application/json: schema: type: object properties: message: type: string example: Authentication failed NotFoundError: description: Resource not found content: application/json: schema: type: object properties: message: type: string example: Resource not found ValidationError: description: Failed due to a formatting error. content: application/json: schema: type: object required: - message properties: message: type: string errors: type: array items: type: object additionalProperties: type: string securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- Bearer token authentication. Obtain token from [Issue a Token](https://docs.engagexpay.com/api-reference/authentication/issue-a-token) endpoint ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.