> ## 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.

# Legacy: Get payout

> Legacy route for retrieving a settlement payout

## Overview

Retrieve a read-only settlement payout by ID.

<Info>
  Payouts are legacy read-only settlement artifacts. Merchant-initiated sends use the [Transfers API](/api-reference/transfers/create-transfer).
</Info>

## Authentication

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

## Path Parameters

<ParamField path="id" type="string" required>
  Unique payout identifier (UUID)

  **Example:** `b2c3d4e5-f6a7-8901-bcde-f23456789abc`
</ParamField>

## Request Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl --request GET \
    --url https://api.daya.co/v1/payouts/b2c3d4e5-f6a7-8901-bcde-f23456789abc \
    --header 'X-Api-Key: YOUR_API_KEY'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://api.daya.co/v1/payouts/b2c3d4e5-f6a7-8901-bcde-f23456789abc',
    {
      headers: {
        'X-Api-Key': 'YOUR_API_KEY'
      }
    }
  );
  const payout = await response.json();
  ```
</CodeGroup>

## Response

Same structure as individual payout objects in list response.

### Success Response

<ResponseExample>
  ```json 200 OK - NGN Payout theme={null}
  {
    "type": "NGN_PAYOUT",
    "id": "b2c3d4e5-f6a7-8901-bcde-f23456789abc",
    "reference": "PAY-NGN-20250105-001",
    "status": "SETTLED",
    "source_currency": "USD",
    "destination_currency": "NGN",
    "source_amount": "100.00",
    "destination_amount": "155050.00",
    "fee": "1.50",
    "rate": {
      "side": "SELL",
      "value": "1550.50",
      "captured_at": "2025-01-05T15:04:05Z"
    },
    "recipient": {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "type": "BANK_ACCOUNT",
      "bank_account": {
        "account_number": "1234567890",
        "account_name": "John Doe",
        "bank_code": "044",
        "bank_name": "Access Bank"
      },
      "crypto_address": null,
      "created_at": "2025-01-05T15:04:05Z"
    },
    "sender": {
      "type": "MERCHANT",
      "id": "c3d4e5f6-a7b8-9012-cdef-345678901abc"
    },
    "tx_hash": null,
    "created_at": "2025-01-05T15:04:05Z",
    "settled_at": "2025-01-05T15:10:00Z"
  }
  ```

  ```json 200 OK - Crypto Payout theme={null}
  {
    "type": "CRYPTO_PAYOUT",
    "id": "d4e5f6a7-b8c9-0123-defg-456789012bcd",
    "reference": "PAY-CRYPTO-20250105-002",
    "status": "SETTLED",
    "source_currency": "USD",
    "destination_currency": "USDC",
    "source_amount": "500.00",
    "destination_amount": "499.25",
    "fee": "0.75",
    "rate": {
      "side": "SELL",
      "value": "1.00",
      "captured_at": "2025-01-05T16:20:00Z"
    },
    "recipient": {
      "id": "e5f6a7b8-c9d0-1234-efgh-567890123cde",
      "type": "CRYPTO_ADDRESS",
      "bank_account": null,
      "crypto_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18",
      "created_at": "2025-01-05T16:18:00Z"
    },
    "sender": {
      "type": "CUSTOMER",
      "id": "f6a7b8c9-d0e1-2345-fghi-678901234def"
    },
    "tx_hash": "0x9a8b7c6d5e4f3a2b1c0d9e8f7a6b5c4d3e2f1a0b9c8d7e6f5a4b3c2d1e0f9a8",
    "created_at": "2025-01-05T16:20:00Z",
    "settled_at": "2025-01-05T16:22:30Z"
  }
  ```

  ```json 404 Not Found theme={null}
  {
    "error": {
      "code": "payout_not_found",
      "message": "Payout not found",
      "details": "No payout with ID b2c3d4e5-f6a7-8901-bcde-000000000000 found for this merchant"
    }
  }
  ```

  ```json 401 Unauthorized theme={null}
  {
    "error": {
      "code": "unauthorized",
      "message": "Invalid or missing API key",
      "details": "Provide a valid API key via the X-Api-Key header"
    }
  }
  ```
</ResponseExample>

## Next Steps

<CardGroup cols={2}>
  <Card title="List Payouts" icon="list" href="/api-reference/payouts/list-payouts">
    View all payouts with filters
  </Card>

  <Card title="List Deposits" icon="arrow-down" href="/api-reference/deposits/list-deposits">
    View incoming deposits
  </Card>
</CardGroup>