---
title: "GET /v1/customers/{customer_id}/recipients/list"
method: GET
path: "/v1/customers/{customer_id}/recipients/list"
tags: ["crate::web::openapi::recipients"]
---

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

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

## Request

- Base URL: `https://api.1money.com`
- URL: `https://api.1money.com/v1/customers/{customer_id}/recipients/list`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/1money/apis/1money-openapi/docs/v1/customers/:customer_id/recipients/list/get.ts> (a function with typed inputs; its response is checked against the schema)

## 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: success, pending_review, blocked
    - `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).
    - `action_required` ActionRequired
      - `type` string, required
      - `case_id` string, required: RFI case business ID.
      - `action` string, required
    - `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

## Changes

- **2026-11-03** `d213edbaccb6`: 4 breaking, 1 warning, 3 info
  - for the `query` request parameter `page`, default value `1` was added
  - for the `query` request parameter `size`, default value `10` was added
  - for the `query` request parameter `page`, the min was increased from `0.00` to `1.00`
  - for the `query` request parameter `size`, the min was increased from `0.00` to `1.00`
  - …4 more

[Operation history](https://skmtc.dev/1money/apis/1money-openapi/changes/v1/customers/:customer_id/recipients/list/get.md)

---

[API](https://skmtc.dev/1money/apis/1money-openapi.md) - [All operations](https://skmtc.dev/1money/apis/1money-openapi/llms.txt) - [OpenAPI document](https://skmtc.dev/1money/apis/1money-openapi/revisions/d213edbaccb6?raw)