Pagination

Pagination is the process of splitting a large result set into smaller chunks. For consistency, the Ardoq API uses the same pagination mechanism for any resource that may return a large result set.

Paginated resources

The following resources may return paginated responses:

• Listing workspaces
• Listing components
• Listing references
• Listing report definitions
• Running a report

Paginated responses

A paginated response is a JSON object that has the following keys values, _links and _meta. These keys are always present.

values

An array containing the results. The type of each item in the array depends on the resource being listed. For example, when listing components, each item in the will be a "component". When running a report each item will be a "row" in the report. To see the type of each item, see the documentation for the resource you are listing.

_links

If the values array does not contain all of the results, an opaque url will be present under _links.next.href. This url can be used to retrieve the next "page" of results. The request should be made with the same headers and authentication as the original request. In order to retrieve all of the results, you should follow the _links.next.href link until you receive a response that does not contain a _links.next key.

_meta

The _meta object contains metadata about the response. The content of this object varies depending on the resource being listed. For example, when running a report the _meta object contains information about the columns.