Pagination

Many endpoints support pagination.

If a response contains a pagination object, you can navigate to the next or previous page by following the URL in the href property of the next or previous object.

If there is no next or previous page, the corresponding object will be null.

In the following example, you can retrieve page 2 of the result set using pagination.next.href:

{
  "pagination": {
    "currentPage": 1,
    "numberOfAvailablePages": 1000,
    "pageSize": 10,
    "nearbyPages": [
      {
        "pageNumber": 1,
        "href": "https://api.proff.no/companies/register/NO?healthStation=false&emergencyRoom=false&pageSize=10&pageNumber=1",
        "rel": "related"
      }
    ],
    "next": {
      "pageNumber": 2,
      "href": "https://api.proff.no/companies/register/NO?healthStation=false&emergencyRoom=false&pageSize=10&pageNumber=2",
      "rel": "next"
    },
    "previous": null,
    "sorting": null
  }
}

Search result limitation

Pagination is limited to 10,000 results.

If a search returns more than 10,000 results, as indicated by numberOfHits, you cannot paginate beyond the first 10,000 results.

This limit applies regardless of the specified pageSize.

If your search returns more than 10,000 results, refine it by adding more keywords or filters.

The Changes endpoint is an exception. It supports retrieving all available results using a different method called scrolling.