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

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

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

## Request

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

## Path parameters

- `customer_id` string, required

## Query parameters

- `idempotency_key` string, required: HTTP `Idempotency-Key` header value. Stricter than other IDs: ≤64 ASCII chars per the common REST API convention.

## Response `200`

Successfully retrieved recipient by idempotency key

- RecipientResponse: Recipient response object
  - `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

## Other responses

- `400`: Invalid request - Missing idempotency_key parameter
- `401`: Authentication failed
- `404`: Recipient not found with the specified idempotency key
- `405`: Method not allowed
- `500`: Internal server error

## Changes

- **2026-11-03** `d213edbaccb6`: 3 info
  - api tag `crate::web::openapi::recipients` added
  - api tag `Recipients (Send to Others)` removed
  - added the optional property `action_required` to the response with the `200` status

[Operation history](https://skmtc.dev/1money/apis/1money-openapi/changes/v1/customers/:customer_id/recipients/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)