Pagination

List endpoints (GET /checkout_sessions, GET /escrows, GET /events, …) return results newest first, a page at a time.

Parameter	Meaning
`limit`	Items per page, 1 to 100. Default 20
`cursor`	The `next_cursor` from the previous page. Leave it out for the first page

{
  "object": "list",
  "data": [ { "id": "...", "object": "escrow" } ],
  "has_more": true,
  "next_cursor": "eyJjIjoiMjAyNi0xMC0xOFQwOToz..."
}

Keep requesting with cursor=<next_cursor> until has_more is false. Cursors are opaque: don’t build or change them.

Filtering

Lists you create resources in also filter by your reference, which is the quickest way to find one:

curl -G https://api.ketapay.com/v1/escrows \
  -d external_reference=order_7781 \
  -H "Authorization: Bearer $KETAPAY_SECRET_KEY"

Await a list for one page, or iterate it to walk every page:

for await (const escrow of ketapay.escrows.list({
  status: 'active',
  limit: 100,
})) {
  console.log(escrow.id)
}

foreach (
    $ketapay->escrows->list([
        'status' => 'active',
        'limit' => 100,
    ])
    as $escrow
) {
    echo $escrow->id;
}