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

> Retrieve a single recipient by ID

## Overview

Retrieve details for a specific recipient belonging to the authenticated merchant. The response shape depends on the recipient's `type`: `BANK_ACCOUNT`, `CRYPTO_ADDRESS`, `US_BANK_ACCOUNT`, or `SWIFT_BANK_ACCOUNT`. Only the field matching the type is populated; the others are `null`.

## Authentication

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

## Path Parameters

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

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

## Request Example

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

  ```javascript JavaScript theme={null}
  const response = await fetch(
    "https://api.daya.co/v1/recipients/750e8400-e29b-41d4-a716-446655440000",
    {
      method: "GET",
      headers: {
        "X-Api-Key": "YOUR_API_KEY",
      },
    }
  );

  const recipient = await response.json();
  ```
</CodeGroup>

## Response

<ResponseField name="id" type="string" required>
  Unique recipient identifier (UUID)
</ResponseField>

<ResponseField name="type" type="string" required>
  Recipient type.

  **Allowed values:** `BANK_ACCOUNT` | `CRYPTO_ADDRESS` | `US_BANK_ACCOUNT` | `SWIFT_BANK_ACCOUNT`
</ResponseField>

<ResponseField name="first_name" type="string">
  Recipient first name (for individual recipients).
</ResponseField>

<ResponseField name="last_name" type="string">
  Recipient last name (for individual recipients).
</ResponseField>

<ResponseField name="bank_account" type="object">
  NGN bank account details. Present when `type` is `BANK_ACCOUNT`, `null` otherwise.

  <Expandable title="bank_account properties">
    <ResponseField name="bank_account.account_name" type="string">
      Resolved account holder name.
    </ResponseField>

    <ResponseField name="bank_account.account_number_last4" type="string">
      Last four digits of the account number.
    </ResponseField>

    <ResponseField name="bank_account.bank_code" type="string">
      Bank code.
    </ResponseField>

    <ResponseField name="bank_account.bank_name" type="string">
      Resolved bank name.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="crypto_address" type="object">
  Crypto address details. Present when `type` is `CRYPTO_ADDRESS`, `null` otherwise.

  <Expandable title="crypto_address properties">
    <ResponseField name="crypto_address.asset" type="string">
      Crypto asset (`USDC` or `USDT`).
    </ResponseField>

    <ResponseField name="crypto_address.chain" type="string">
      Blockchain network.
    </ResponseField>

    <ResponseField name="crypto_address.address" type="string">
      Wallet address.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="us_bank_account" type="object">
  US bank account details. Present when `type` is `US_BANK_ACCOUNT`, `null` otherwise.

  <Expandable title="us_bank_account properties">
    <ResponseField name="us_bank_account.account_owner_name" type="string">
      Account owner name.
    </ResponseField>

    <ResponseField name="us_bank_account.account_number_last4" type="string">
      Last four digits of the account number.
    </ResponseField>

    <ResponseField name="us_bank_account.routing_number" type="string">
      ABA routing number.
    </ResponseField>

    <ResponseField name="us_bank_account.bank_name" type="string">
      Bank name.
    </ResponseField>

    <ResponseField name="us_bank_account.account_type" type="string">
      Account type (e.g., `checking`, `savings`).
    </ResponseField>

    <ResponseField name="us_bank_account.payout_scheme" type="string">
      Payout scheme (e.g., `ach`, `wire`).
    </ResponseField>

    <ResponseField name="us_bank_account.address" type="object">
      Recipient address.

      <Expandable title="address properties">
        <ResponseField name="us_bank_account.address.street_line_1" type="string">
          Street line 1.
        </ResponseField>

        <ResponseField name="us_bank_account.address.street_line_2" type="string">
          Street line 2.
        </ResponseField>

        <ResponseField name="us_bank_account.address.city" type="string">
          City.
        </ResponseField>

        <ResponseField name="us_bank_account.address.state" type="string">
          State or subdivision.
        </ResponseField>

        <ResponseField name="us_bank_account.address.postal_code" type="string">
          Postal code.
        </ResponseField>

        <ResponseField name="us_bank_account.address.country" type="string">
          ISO 3166-1 alpha-3 country code.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="swift_bank_account" type="object">
  SWIFT bank account details. Present when `type` is `SWIFT_BANK_ACCOUNT`, `null` otherwise.

  <Expandable title="swift_bank_account properties">
    <ResponseField name="swift_bank_account.account_owner_name" type="string">
      Account owner name.
    </ResponseField>

    <ResponseField name="swift_bank_account.account_owner_type" type="string">
      Account owner type: `individual` or `business`.
    </ResponseField>

    <ResponseField name="swift_bank_account.first_name" type="string">
      First name (for individual owners).
    </ResponseField>

    <ResponseField name="swift_bank_account.last_name" type="string">
      Last name (for individual owners).
    </ResponseField>

    <ResponseField name="swift_bank_account.business_name" type="string">
      Business name (for business owners).
    </ResponseField>

    <ResponseField name="swift_bank_account.short_business_description" type="string">
      Short business description.
    </ResponseField>

    <ResponseField name="swift_bank_account.category" type="string">
      Relationship category: `client`, `parent_company`, `subsidiary`, or `supplier`.
    </ResponseField>

    <ResponseField name="swift_bank_account.account_country" type="string">
      ISO 3166-1 alpha-3 country code of the account.
    </ResponseField>

    <ResponseField name="swift_bank_account.bank_name" type="string">
      Bank name.
    </ResponseField>

    <ResponseField name="swift_bank_account.bic" type="string">
      Bank Identifier Code (SWIFT/BIC).
    </ResponseField>

    <ResponseField name="swift_bank_account.iban_last4" type="string">
      Last four characters of the IBAN.
    </ResponseField>

    <ResponseField name="swift_bank_account.purpose_of_funds" type="array">
      Declared purpose(s) of funds.
    </ResponseField>

    <ResponseField name="swift_bank_account.address" type="object">
      Recipient address (same shape as `us_bank_account.address`).
    </ResponseField>

    <ResponseField name="swift_bank_account.bank_address" type="object">
      Bank address (same shape as `us_bank_account.address`).
    </ResponseField>
  </Expandable>
</ResponseField>

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

### Success Response

<ResponseExample>
  ```json 200 OK - Bank Account (NGN) theme={null}
  {
    "id": "750e8400-e29b-41d4-a716-446655440000",
    "type": "BANK_ACCOUNT",
    "first_name": "John",
    "last_name": "Doe",
    "bank_account": {
      "account_name": "John Doe",
      "account_number_last4": "7890",
      "bank_code": "044",
      "bank_name": "Access Bank"
    },
    "crypto_address": null,
    "us_bank_account": null,
    "swift_bank_account": null,
    "created_at": "2026-01-05T15:04:05Z"
  }
  ```

  ```json 200 OK - Crypto Address theme={null}
  {
    "id": "850e8400-e29b-41d4-a716-446655440000",
    "type": "CRYPTO_ADDRESS",
    "first_name": null,
    "last_name": null,
    "bank_account": null,
    "crypto_address": {
      "asset": "USDC",
      "chain": "BASE",
      "address": "0x1234567890abcdef1234567890abcdef12345678"
    },
    "us_bank_account": null,
    "swift_bank_account": null,
    "created_at": "2026-01-05T15:04:05Z"
  }
  ```

  ```json 200 OK - US Bank Account theme={null}
  {
    "id": "950e8400-e29b-41d4-a716-446655440000",
    "type": "US_BANK_ACCOUNT",
    "first_name": "Jane",
    "last_name": "Smith",
    "bank_account": null,
    "crypto_address": null,
    "us_bank_account": {
      "account_owner_name": "Jane Smith",
      "account_number_last4": "6789",
      "routing_number": "021000021",
      "bank_name": "JPMorgan Chase",
      "account_type": "checking",
      "payout_scheme": "ach",
      "address": {
        "street_line_1": "123 Main St",
        "city": "New York",
        "state": "NY",
        "postal_code": "10001",
        "country": "USA"
      }
    },
    "swift_bank_account": null,
    "created_at": "2026-01-05T15:04:05Z"
  }
  ```

  ```json 200 OK - SWIFT Bank Account theme={null}
  {
    "id": "a50e8400-e29b-41d4-a716-446655440000",
    "type": "SWIFT_BANK_ACCOUNT",
    "first_name": "Aisha",
    "last_name": "Ahmed",
    "bank_account": null,
    "crypto_address": null,
    "us_bank_account": null,
    "swift_bank_account": {
      "account_owner_name": "Aisha Ahmed",
      "account_owner_type": "individual",
      "first_name": "Aisha",
      "last_name": "Ahmed",
      "category": "client",
      "account_country": "GBR",
      "bank_name": "HSBC UK",
      "bic": "HBUKGB4B",
      "iban_last4": "3210",
      "purpose_of_funds": ["personal_or_living_expenses"],
      "address": {
        "street_line_1": "10 Downing St",
        "city": "London",
        "postal_code": "SW1A 2AA",
        "country": "GBR"
      },
      "bank_address": {
        "street_line_1": "8 Canada Square",
        "city": "London",
        "postal_code": "E14 5HQ",
        "country": "GBR"
      }
    },
    "created_at": "2026-01-05T15:04:05Z"
  }
  ```
</ResponseExample>

## Error Responses

<ResponseExample>
  ```json 400 Bad Request - Invalid UUID theme={null}
  {
    "error": {
      "code": "BAD_REQUEST",
      "message": "Invalid UUID format",
      "request_id": "550e8400-e29b-41d4-a716-446655440000"
    }
  }
  ```

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

## Next Steps

<CardGroup cols={2}>
  <Card title="List recipients" icon="list" href="/api-reference/recipients/list-recipients">
    Retrieve all saved recipients
  </Card>

  <Card title="Delete recipient" icon="trash" href="/api-reference/recipients/delete-recipient">
    Remove a payout recipient
  </Card>
</CardGroup>