---
title: "Get Recipient by Idempotency Key"
method: GET
path: "/v1/customers/{customer_id}/recipients"
tags: ["Recipients (Send to Others)"]
---

# Get Recipient by Idempotency Key

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

Retrieve a recipient using its idempotency key.

**Functionality:**
- Looks up a recipient by the idempotency key provided during creation
- Useful for safely retrying create requests

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

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

---

[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)