> ## Documentation Index
> Fetch the complete documentation index at: https://docs.daya.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Get transfer

> Retrieve a single transfer by ID

## Overview

Retrieves a single merchant-initiated transfer by ID for the authenticated merchant.

## Authentication

<ParamField header="X-Api-Key" type="string" required>
  Your merchant API key
</ParamField>

## Path Parameters

<ParamField path="id" type="string" required>
  Transfer ID (UUID format)

  **Example:** `850e8400-e29b-41d4-a716-446655440000`
</ParamField>

## Request Example

<CodeGroup>
  ```bash cURL theme={null}
  curl --request GET \
    --url https://api.daya.co/v1/transfers/850e8400-e29b-41d4-a716-446655440000 \
    --header 'X-Api-Key: YOUR_API_KEY'
  ```
</CodeGroup>

## Response

<ResponseField name="id" type="string" required>
  Transfer ID (UUID)
</ResponseField>

<ResponseField name="reference" type="string" required>
  Merchant-provided reference
</ResponseField>

<ResponseField name="status" type="string" required>
  External status: `PROCESSING`, `SETTLED`, or `FAILED`
</ResponseField>

<ResponseField name="rail" type="string" required>
  Transfer rail: `NGN_BANK` or `USD_BANK`
</ResponseField>

<ResponseField name="currency" type="string" required>
  Transfer currency (`NGN` or `USD`)
</ResponseField>

<ResponseField name="amount" type="string" required>
  Transfer amount in the target currency
</ResponseField>

<ResponseField name="debit_currency" type="string" required>
  Currency debited from the merchant balance (`USD`)
</ResponseField>

<ResponseField name="debit_amount" type="string" required>
  Total amount debited from the merchant withdrawal balance, including fees
</ResponseField>

<ResponseField name="fee" type="string" required>
  Fee charged for the transfer
</ResponseField>

<ResponseField name="rate" type="object">
  Captured exchange rate snapshot (present for NGN transfers)
</ResponseField>

<ResponseField name="recipient" type="object">
  Resolved recipient details
</ResponseField>

<ResponseField name="on_behalf_of" type="object">
  Customer metadata if provided
</ResponseField>

<ResponseField name="created_at" type="string" required>
  When the transfer was created (ISO 8601)
</ResponseField>

<ResponseField name="settled_at" type="string">
  When the transfer settled (ISO 8601)
</ResponseField>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "id": "850e8400-e29b-41d4-a716-446655440000",
    "reference": "txn_ngn_001",
    "status": "SETTLED",
    "rail": "NGN_BANK",
    "currency": "NGN",
    "amount": "50000.00",
    "debit_currency": "USD",
    "debit_amount": "33.07",
    "fee": "0.81",
    "rate": {
      "side": "SELL",
      "value": "1550.00",
      "captured_at": "2026-01-05T15:04:05Z"
    },
    "recipient": {
      "id": "750e8400-e29b-41d4-a716-446655440000",
      "type": "BANK_ACCOUNT",
      "bank_account": {
        "account_name": "John Doe",
        "account_number_last4": "7890",
        "bank_code": "044",
        "bank_name": "Access Bank"
      }
    },
    "on_behalf_of": null,
    "created_at": "2026-01-05T15:04:05Z",
    "settled_at": "2026-01-05T15:10:00Z"
  }
  ```

  ```json 404 Not Found theme={null}
  {
    "error": {
      "code": "NOT_FOUND",
      "message": "Transfer not found",
      "request_id": "550e8400-e29b-41d4-a716-446655440000"
    }
  }
  ```
</ResponseExample>