---
title: "List Recipients"
method: GET
path: "/v1/customers/{customer_id}/recipients/list"
tags: ["Recipients (Send to Others)"]
---

# List Recipients

`GET /v1/customers/{customer_id}/recipients/list`

Retrieve all recipients for a specific customer with optional search and pagination.

**Functionality:**
- Returns recipients ordered by creation time (most recent first)
- Supports search by name, nickname, or email

## Path parameters

- `customer_id` string, required

## Query parameters

- `search` string
- `page` integer
- `size` integer

## Response `200`

Successfully retrieved list of recipients

- RecipientListResponse — Response for recipient list
  - `list` RecipientResponse[], required
    - `recipient_id` string, required — Counterparty ID. Empty values are still allowed for legacy DB columns where an empty cpid means the record is not tied to a recipient.
    - `customer_id` string, required — Portfolio ID — also exposed as `customer_id` in OpenAPI. Identifies one individual application / portfolio row within an entity.
    - `business_type` string, required — Recipient type: INDIVIDUAL or COMPANY
    - `full_name` string, required — Full name computed from name fields
    - `nickname` string, nullable — User-defined nickname (optional)
    - `email` string, nullable — Email address (optional)
    - `relationship` string, nullable — Relationship to the customer (optional)
    - `status` string, required — Recipient status. Possible values: active, in_review, failed
    - `address` AddressDetails
      - `full_address` string, required
      - `country_code` string, required — ISO 3166-1 alpha-3 three-letter country codes in upper case.
      - `address_line1` string, required — The street number for this address (the whitespaces are trimmed from field).
      - `address_line2` string, nullable — An additional address line for this address (the whitespaces are trimmed from field).
      - `city` string, required — A city for this address (the whitespaces are trimmed from field).
      - `region` string, nullable — The address's region. This is state for U.S., province for Canada (the whitespaces are trimmed from field).
      - `postal_code` string, required — A postal code for this address (the whitespaces are trimmed from field).
    - `created_at` string, date-time, required — Created timestamp
    - `modified_at` string, date-time, required — Last modified timestamp
  - `total` integer, nullable

## Other responses

- `400` — Invalid request parameters
- `401` — Authentication failed
- `405` — Method not allowed
- `500` — Internal server error

---

[API](https://skmtc.net/1money/apis/1money-openapi.md) · [All operations](https://skmtc.net/1money/apis/1money-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/1money/1money-openapi/revisions/aa2718d28cb5/schema)