Pagination

On many endpoints pagination is supported. If the response contains a pagination object you can go the next or previous page by following the URL specified in href of next and previous objects. If ther is no next or previous page the object will be null.

For example, given the below response you can navigate to 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"
      },
    // More nearby pages...
    ],
    "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 your search request returns more than 10 000 results (check numberOfHits) you will not be able to paginate beyond this. This limit applies regardless of what pageSize you specify. If you get more than 10 000 results you should try to refine your search by adding more keywords or filters.

The exception to this rule is the Changes endpoint, which supports retrieving all results using a different method referred to as scrolling.