All top-level API resources that have support for "list" calls are paginated. For instance, you can list songs. These list API methods share a common structure, taking two optional query parameters nested under a page key: size and number.

Query Parameters

Query ParameterDefaultDescription
page[size]10The number of results from 1-100 to return.
page[number]1The page to return, one-indexed.

Links Example

List endpoints also return a top-level links object that allows you to easily traverse the list.

  "links": {
    "self": "",
    "first": null,
    "prev": null,
    "next": "",
    "last": "",
    "meta": {
      "total_count": 8000