Pagination - Payluk API

List endpoints accept page and limit query parameters and return a pagination object alongside the data array.

Request

GET /v1/escrow/transactions?type=sales&page=1&limit=10

Parameter	Default	Description
`page`	`1`	Page number (1-based).
`limit`	`10`	Items per page.

Transaction history (GET /v1/payment/history and GET /v1/merchant/transactions) accepts a limit between 1 and 100. A larger value is capped at 100, and an unusable one falls back to 10, so a malformed request still returns a sensible page rather than an error or an empty result.

Response

Paginated payloads nest the records under data.data, with a sibling pagination object:

{
  "status": 200,
  "message": "Transaction fetched successfully",
  "data": {
    "data": [
      { "id": "665f1b2c9a1e4d0012ab3c10", "amount": 150000, "status": "ONGOING" }
    ],
    "pagination": {
      "count": 1,
      "pages": 1,
      "isLastPage": true,
      "nextPage": null,
      "previousPage": null
    }
  }
}

Field	Description
`count`	Total number of matching records.
`pages`	Total number of pages.
`isLastPage`	`true` when there are no further pages.
`nextPage`	The next page number, or `null` on the last page.
`previousPage`	The previous page number, or `null` on the first page.

To iterate the full set, keep requesting nextPage until isLastPage is true.