Pagination - Aquila

Every list endpoint shares one contract.

Query parameters

Parameter	Type	Behavior
`q`	string	Case-insensitive contains search, where supported.
`page`	integer	Page number, 1-based.
`limit`	integer	Items per page. 1 to 100, default 20.
`sort`	enum	`createdAt` or `updatedAt`. Default `createdAt`.
`order`	enum	`asc` or `desc`. Default `desc`.

Some lists add filters of their own. Examples: ?status= on reports, and ?scanId= on agent sessions. The endpoint pages in the API reference name the extras.

Envelope

List endpoints return one shape:

{
  "items": [],
  "total": 128,
  "page": 1,
  "limit": 20,
  "totalPages": 7
}

items — the rows for this page.
total — the row count for the whole filter, not the page.
totalPages — ceil(total / limit).

Send page until page equals totalPages. Aquila scopes every list to your user. You never see another account’s rows.