Pagination

Most Asset API endpoints that return lists of objects support pagination, allowing you to retrieve data in smaller chunks. Asset uses cursor-based pagination, which ensures no records are skipped between pages and provides better performance than offset-based pagination.

​

Paginating Through Records

When an endpoint supports pagination, the API response includes pagination tokens:

{
  "next_page_token": "xK8QZ5JpT0L4FzDc6VaRb1MNhgAAAAABk9cXz3G2hJn7Yx2K1Nv==",
  "previous_page_token": "pT0L4FzDc6VaRb1MNhxK8QZ5JgAAAAABk9cXz3G2hJn7Yx2K1Nv==",
  "records": []
}

• Use next_page_token to request the next page.
• Use previous_page_token to request the previous page.
• If either token is null, there are no additional pages in that direction.

To retrieve the next page, include the page_token parameter in your request:

curl --request GET \
  --url "https://api.asset.com/v1/ledgers?page_token=<next_page_token>" \
  --header "Authorization: Bearer <token>"

To request the previous page:

curl --request GET \
  --url "https://api.asset.com/v1/ledgers?page_token=<previous_page_token>" \
  --header "Authorization: Bearer <token>"

​

Page Size

By default, the API returns 50 records per page, with a maximum of 100 records per page. You can adjust this by setting the page_size parameter:

curl --request GET \
--url 'https://api.asset.com/v1/ledgers?page_token=<next_page_token>&page_size=100' \
--header 'Authorization: Bearer <token>'