Pagination - Demat Escrow API

List endpoints return a page of results, not the entire collection. Pagination uses limit and offset, the same pattern as other Demat APIs.

Query parameters

Parameter	Type	Description
`limit`	integer	Page size. Default 20, minimum 1, maximum 100.
`offset`	integer	Number of records to skip. Default 0. Use `0`, then `20`, then `40`, and so on.
`status`	string	List filter where supported. Escrows: escrow status. Checkouts: session status.
`customerId`	string	Escrow, checkout, wallet, and withdrawal lists. Escrows: payer or payee. Checkouts: that customer. Wallets: that wallet. Withdrawals: transfers that debit that customer.
`escrowId`	string	Checkout list only. Sessions that fund this hold.

Response shape

{
  "success": true,
  "data": {
    "customers": [{ "customerId": "cus_01hxyz" }],
    "pagination": {
      "total": 42,
      "limit": 20,
      "offset": 0,
      "hasMore": true
    }
  },
  "meta": {
    "requestId": "req_01hxyz"
  }
}

Field	Description
named array	The page of records. The key matches the resource: `customers`, `transactions`, `escrows`, `checkouts`, `wallets`, `withdrawals`, `bankAccounts`.
`pagination.total`	Total matching records.
`pagination.limit`	Page size used for this request.
`pagination.offset`	How many records were skipped.
`pagination.hasMore`	`true` when `offset + limit < total`.

Walking a list

Call the list endpoint with limit=20 and offset=0 (or omit both for those defaults).
If pagination.hasMore is true, call again with the same limit and offset set to the previous offset + limit.
Stop when hasMore is false.

Escrow list accepts status and customerId. Checkout list accepts status, escrowId, and customerId. Wallet list accepts customerId. Withdrawal list accepts status and customerId.