---
title: "List Recipients"
method: GET
path: "/v1/recipients"
tags: ["public.recipients"]
---

# List Recipients

`GET /v1/recipients`

Lists saved payout recipients for the authenticated merchant with optional filtering and pagination

## Query parameters

- `type` 'BANK_ACCOUNT' | 'CRYPTO_ADDRESS'
- `customer_id` string
- `search` string
- `limit` integer
- `page` integer

## Response `200`

OK

- ListRecipientsResponse
  - `data` RecipientResponse[]
    - `bank_account` BankAccountResponse
      - `account_name` string
      - `account_number_last4` string
      - `bank_code` string
      - `bank_name` string
    - `created_at` string
    - `crypto_address` CryptoAddressResponse
      - `address` string
      - `asset` string
      - `chain` string
    - `first_name` string
    - `id` string
    - `last_name` string
    - `swift_bank_account` SWIFTBankAccountResponse
      - `account_country` string
      - `account_owner_name` string
      - `account_owner_type` string
      - `address` RecipientAddressInput
        - `city` string, required
        - `country` string, required
        - `postal_code` string, required
        - `state` string
        - `street_line_1` string, required
        - `street_line_2` string
      - `bank_address` RecipientAddressInput
        - `city` string, required
        - `country` string, required
        - `postal_code` string, required
        - `state` string
        - `street_line_1` string, required
        - `street_line_2` string
      - `bank_name` string
      - `bic` string
      - `business_name` string
      - `category` string
      - `first_name` string
      - `iban_last4` string
      - `last_name` string
      - `purpose_of_funds` string[]
      - `short_business_description` string
    - `type` string
    - `us_bank_account` USBankAccountResponse
      - `account_number_last4` string
      - `account_owner_name` string
      - `account_type` string
      - `address` RecipientAddressInput
        - `city` string, required
        - `country` string, required
        - `postal_code` string, required
        - `state` string
        - `street_line_1` string, required
        - `street_line_2` string
      - `bank_name` string
      - `payout_scheme` string
      - `routing_number` string
  - `limit` integer
  - `page` integer
  - `total` integer
  - `total_pages` integer

## Other responses

- `400` — Invalid query parameters
- `401` — Unauthorized
- `500` — Internal server error

---

[API](https://skmtc.dev/daya/apis/daya-external-api-public-api.md) · [All operations](https://skmtc.dev/daya/apis/daya-external-api-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/daya/daya-external-api-public-api/revisions/5fc72bf91a48/schema)