Skip to main content
Every Yuno list endpoint (GET /v1/customers, /v1/recipients, /v1/reports, etc.) uses the same cursor model — the parameters and response shape do not vary across resources. Lists return at most 20 records by default. The model is the same one Stripe uses.
ParameterTypeDefaultPurpose
limitinteger20Records per page (max 100).
starting_afterstring (resource id)Return results immediately after this id (next page).
ending_beforestring (resource id)Return results immediately before this id (previous page).
# Page 1
curl "https://api-sandbox.y.uno/v1/customers?limit=20" \
  -H "public-api-key: $YUNO_PUBLIC_API_KEY" \
  -H "private-secret-key: $YUNO_PRIVATE_SECRET_KEY"

# Page 2 — pass the id of the last record from page 1
curl "https://api-sandbox.y.uno/v1/customers?limit=20&starting_after=cust_01HX..." \
  -H "public-api-key: $YUNO_PUBLIC_API_KEY" \
  -H "private-secret-key: $YUNO_PRIVATE_SECRET_KEY"
Use starting_after to walk forward through results. Stop when the response returns fewer than limit records.