Pagination

Our List API endpoints (e.g. GET /projects) return a limited number of results each request.

By default, we return 50 results per page. You can change the number of results returned to any number between 1 and 200 with the ?per_page query parameter, e.g. GET /jobs?per_page=20.

You can also page through the results using the page query parameter (e.g. GET /jobs?page=2).

You can also use these parameters together (e.g. GET /jobs?per_page=20&page=2).

At the end of a response object for a List API endpoint, a meta field including pagination information is returned. If you want to get all results, it is recommended that you continue paginating (by increasing the value of ?page=) until you get an empty result set.

{
    "data": [
        {
            "id": "15baed1e-7eff-52f4-8fef-3851b4a509d6",
            "source_id": "1120",
            "name": "Job 1120",
            "status": "Completed",
            "description": "Call customer before arrival.",
        },
        {
            "id": "1e9df19c-161f-5b18-96ee-21a19c14ff28",
            "source_id": "2172",
            "name": "Job 2172",
            "status": "Completed",
            "description": "Call customer before arrival.",
        }
    ],
    "meta": {
        "current_page": 1,
        "has_more_results": false // true, false, or null (if unknown)
    }
}

Note: Certain Source Systems may return a value of null for has_more_results.