All resources that use list API methods use page-based pagination.

​
Request Parameters

The following query parameters should be included in the request:

​
page
number
default:
"none"
required

The page number to retrieve (starting from 1)

​
page_size
number
default:
"10"

The number of items to return per page (maximum 100)

​
Meta Object Properties

The API response will include a meta object containing pagination information:

​
current_page
number
required

The current page number

​
page_size
number
required

The number of items per page

​
total_items
number
required

The total number of items across all pages

​
total_pages
number
required

The total number of pages

​
next_page_url
string

URL for the next page (if available)

​
previous_page_url
string

URL for the previous page (if available)

​
first_page_url
string
required

URL for the first page

​
last_page_url
string
required

URL for the last page

​
Best Practices

  1. Use page and page_size query parameters when making requests to list endpoints.
  2. Respect the maximum page_size limit of 100 items per page.
  3. Use the provided URLs in the meta object for navigation between pages.
  4. next_page_url or previous_page_url might be null.

​
Limitations

  • The maximum allowed page_size is 100 items per page.
  • If a page_size greater than 100 is requested, the API will return an error.
IntroductionRate limits