List recipients
List the recipients belonging to a single user. A user_id query parameter is REQUIRED — omitting it returns 400 "user_id query parameter is required". The response is an envelope ({ recipients, total }), not a top-level array.
Authorizations
Access token from POST /auth (the data.access_token value).
API key issued by Kira. Required on every request, including /auth.
Headers
Optional. The date-versioned API version to apply for this request (e.g. 2026-04-14). When sent it always wins, even over your pinned account default. When omitted, the API uses your account's pinned version if set, otherwise a baseline default.
"2026-04-14"
Query Parameters
REQUIRED. UUID of the user whose recipients to list. Omitting it returns 400 "user_id query parameter is required"; a user_id that does not belong to the caller returns 404 USER_NOT_FOUND.
Optional metadata filter using Stripe-style deepObject syntax, e.g. ?metadata[order_id]=ord_12345. Returns only recipients whose metadata matches every supplied key/value.