Pagination

All queries support offset-based pagination via the limit and offset parameters.

Parameter Default Maximum Description
limit 100 500 Number of rows to return per request
offset 0 — Number of rows to skip before returning results

The response does not indicate whether more pages exist. You can infer that by counting the number of rows returned and comparing it with the limit used in the query.

To page through a large result set, increment offset by limit on each successive request:

Page 1 — first 100 rows:

JSON 
{
  "parameters": [
    { "name": "start_time", "value": "2024-01-01T00:00:00Z" },
    { "name": "end_time",   "value": "2024-01-31T23:59:59Z" },
    { "name": "limit",      "value": "100" },
    { "name": "offset",     "value": "0" }
  ]
}

Page 2 — rows 101–200:

JSON 
{
  "parameters": [
    { "name": "start_time", "value": "2024-01-01T00:00:00Z" },
    { "name": "end_time",   "value": "2024-01-31T23:59:59Z" },
    { "name": "limit",      "value": "100" },
    { "name": "offset",     "value": "100" }
  ]
}

Page 3 — rows 201–300:

JSON 
{
  "parameters": [
    { "name": "start_time", "value": "2024-01-01T00:00:00Z" },
    { "name": "end_time",   "value": "2024-01-31T23:59:59Z" },
    { "name": "limit",      "value": "100" },
    { "name": "offset",     "value": "200" }
  ]
}

When the number of rows returned is less than limit, you have reached the last page.

Warning: limit must be a positive integer and cannot exceed 500. offset must be zero or a positive integer. Supplying values outside these bounds returns a 400 Bad Request error.