Get Recipient by Merchant ID
Retrieve a single recipient using the identifier assigned by your organization.
GET /v1/recipients?merchant_recipient_id=... to look up a recipient by your merchant recipient ID. The lookup is scoped to your organization and does not require account_id.
A successful request returns a top-level recipient object. If no recipient matches, the endpoint returns HTTP 400 with code RECIPIENT_NOT_FOUND. The merchant_recipient_id query parameter is required.
This endpoint keeps its existing behavior. Existing integrations that use it to look up a recipient do not need to change.
For a paginated collection, use List Recipients at GET /v1/recipients/list. That endpoint returns a data array and pagination, including an empty array when no recipients match. Integrations or cron jobs that need a list should use /list.
To look up a recipient by its Yuno ID, use Get Recipient.Authorizations
Query Parameters
The recipient identifier assigned by the merchant.
1Response
Success Response
The unique identifier of the recipient.
"3aaa4d82-11e8-48ce-8ef5-04eee3a10802"
The account identifier associated with this recipient.
"fe14c7c6-c75e-43b7-bdbe-4c87ad52c482"
Unique identifier of the recipient defined by the merchant.
"MERCHANT_182acf1d-faeb-4ff0-94cd-7fab11b282f6"
Beneficiary's national entity type.
"INDIVIDUAL"
Beneficiary's type of organization.
"PRIVATE"
Beneficiary's name.
"Juan"
Beneficiary's last name.
"Perez"
Beneficiary's legal name.
null
The Beneficiary's email.
"juan.perez@example.com"
Beneficiary's date of birth.
"1990-01-15"
The Beneficiary's country.
"CO"
The seller's website URL.
"https://juanperez.com"
The seller's industry.
"Technology"
The merchant category code (MCC) (MAX 235; MIN 1).
"5734"
Rules for automatic split calculation at the recipient level.
Recipient creation date (ISO 8601 MAX 27; MIN 27).
"2025-08-27T15:41:19.497413Z"
Last Recipient updated date (ISO 8601 MAX 27; MIN 27).
"2025-08-27T15:41:19.497425Z"