Skip to main content
Most endpoints that return a list of entities support filtering and pagination. Use the following URL paramaters to control the content returned by the endpoint.
ParameterDescriptionDefault value
cursorEndpoints that support pagination and have more results available will return a cursor value in meta.cursor . Use this value to retrieve the next page of results.undefined
limitLimit the number of results, with a minimum value of 1 and a maximum value of 100.50

Response structure

Endpoints returning a list of entities will always return an object containing two keys:
  • items : An array of entities
  • meta: An object with the following keys:
    • total : The total number of items of this resource
    • links : Direct links to the current resource, and first and last pages.
    • cursor: The value of the cursor to use to retrieve the next page
{
  "items": [/* ... */],
  "meta": {
    "total": 241,
    "cursor": "9b8e2d44",
    "links": {
      "self": {
        "href": "https://api.algure.com/v1/countings?cursor=6f3e7f9a"
      },
      "first": {
        "href": "https://api.algure.com/v1/countings"
      },
      "next": {
        "href": "https://api.algure.com/v1/countings?cursor=9b8e2d44"
      }
    }
  }
}