Pagination

List endpoints may return paginated results. When a response includes last_evaluated_key, more items are available. Include this value in subsequent requests to fetch the next page.

Pagination is forward-only. You cannot navigate to previous pages.

How pagination works

Send initial request

Send a request with page_size to specify how many items you want per page.

Receive first page

The response includes items and last_evaluated_key if more pages exist.

Request next page

Include the last_evaluated_key from the previous response in your next request.

Repeat until complete

Continue until the response doesn’t include last_evaluated_key, indicating you’ve reached the last page.

Request parameters

integer

Maximum items to return per page (up to 50)

string

Cursor from previous response to fetch the next page

Response fields

array

Results for the current page

string

Present only when more pages exist. Include in your next request to continue.

Example

First request

{
  "@entity": "in.co.sandbox.tds.reports.jobs.search",
  "tan": "AHMQ00112A",
  "quarter": "Q1",
  "form": "24Q",
  "financial_year": "FY 2024-25",
  "from_date": 1765530000000,
  "to_date": 1765536568538,
  "page_size": 10
}

First response

{
  "code": 200,
  "timestamp": 1715757773000,
  "transaction_id": "109469b2-0748-4135-a569-e86fc9e45756",
  "data": {
    "@entity": "in.co.sandbox.tds.reports.paginated_list",
    "items": [
      { /* job item */ },
      { /* job item */ }
    ],
    "last_evaluated_key": "ZDVkMzAyZmUtMWFjYS00YjkxLTgyMWUtMTQxYmM4ZGE1NmNmIA=="
  }
}

Next request

Include the last_evaluated_key from the previous response:

{
  "@entity": "in.co.sandbox.tds.reports.jobs.search",
  "tan": "AHMQ00112A",
  "quarter": "Q1",
  "form": "24Q",
  "financial_year": "FY 2024-25",
  "from_date": 1765530000000,
  "to_date": 1765536568538,
  "page_size": 10,
  "last_evaluated_key": "ZDVkMzAyZmUtMWFjYS00YjkxLTgyMWUtMTQxYmM4ZGE1NmNmIA=="
}

Get Started

Developer Resources

Products

Billing & Invoicing

Request parameters

Response fields

Example

First request

First response

Next request

​How pagination works

​Request parameters

​Response fields

​Example

​First request

​First response

​Next request

How pagination works

Request parameters

Response fields

Example

First request

First response

Next request