Pagination

Any API endpoint that returns an array of results may page them. The number of results per page depends on the endpoint and can change over time. When results are paged, the response includes a Link header that tells you how to get the next page.

For example, query the List Cards endpoint:

curl -u $GURU_USER:$GURU_TOKEN https://api.getguru.com/api/v1/search/query

If the response contains 50 results but more exist, it includes a Link header pointing to the next page:

Link: < https://api.getguru.com/api/v1/search/query?token=xsfwsgsgi248rhfn2oir987kjowidjf9w87et9w8etwt >; rel="next-page"

To get the next page, make another request to the URL in the header:

curl -u $GURU_USER:$GURU_TOKEN "https://api.getguru.com/api/v1/search/query?token=xsfwsgsgi248rhfn2oir987kjowidjf9w87et9w8etwt"

If that response also has a Link header, there are still more results. When a response has no Link header, you have retrieved every page.