The page and page_size Query Parameters

The page and page_size query parameters are used in conjunction most of the time on requests that return object lists. The query parameter page_size allows you to set the number of objects returned in one page, while page allows you to specify the page number you want to view, based on a specified number or the default page_size of 50.

The APIs use these query parameters themselves to construct links to the next and previous page of any list of objects. For example, if you request the URL:

GET /api/v2/measurements/

You'll see that the API returns a next field that contains a link with the query parameters ?page=2.

There are some important things to note when using these query parameters:

• Values over 500 on the query parameter page_size will be automatically limited to 500
• Using the page and page_size parameters is meant to limit the size of responses to be more convenient for users. Using many requests with small limits will not speed up (or slow down), the RIPE Atlas APIs. Using many small requests will, however, require more overhead on your network connection in comparison to one big request to RIPE Atlas.