A resource which returns a list doesn't return all results at once. Instead, the number of results is constrained and you can traverse the results. For that purpose, the list requests accept the parameters max and offset.

Request ParameterDefault ValueDescription
max10Maximal number of returned resources. Maximal allowed value is 100.
offset0The offset from the first result to list from.

All list responses return a number of total results in HTTP response header.

HTTP Response HeaderDescription
x-total-countNumber of total results.

An example which returns the 21st to 30th resource:

curl-H "Content-Type: application/json" -H "Authorization: Bearer {{OAUTH_TOKEN}}"