Recipients for Marketplace
List Recipients
Retrieve a paginated list of recipients for an authorized account.
GET
List Recipients
Provide
account_id as a query parameter, or X-Account-Code as a header. If both are present, the query parameter takes precedence. Results are scoped to that authorized account and your organization, ordered by creation date, newest first.
Use merchant_recipient_id for an exact match, optionally combined with country and national_entity. Every successful response contains data as an array and pagination as an object, including when only one recipient matches. No match returns HTTP 200 with data: [] and pagination.total: 0.
limit defaults to 20 and accepts 1 to 100. offset defaults to 0 and accepts any nonnegative integer. Empty or repeated filter values are invalid.
Each item contains the recipient’s base fields. Related collections such as withdrawal_methods, documentation, legal_representatives and onboardings are not enriched. Use Get Recipient for the full recipient.
This list is available at
GET /v1/recipients/list. The existing Get Recipient by Merchant ID lookup (GET /v1/recipients?merchant_recipient_id=...) remains unchanged: it returns a top-level recipient object and 400 RECIPIENT_NOT_FOUND when no recipient matches. Existing lookup callers do not need to migrate. GET by Yuno ID and PATCH/DELETE contracts are unchanged.Authorizations
Headers
Authorized account UUID when account_id is omitted. If both are present, account_id takes precedence.
Query Parameters
Maximum number of recipients to return
Required range:
1 <= x <= 100Number of recipients to skip for pagination
Required range:
x >= 0Filter recipients by national entity type
Available options:
INDIVIDUAL, ENTITY Filter recipients by country
Exact merchant recipient ID filter. Returns the same data array and pagination envelope; no match returns an empty array with total 0.
Minimum string length:
1Authorized account UUID. Required unless X-Account-Code is supplied in the request header.