From a95d772125ce1837bfdf5c159ba779bab7ffdd44 Mon Sep 17 00:00:00 2001 From: Klimenty Stuzhev Date: Fri, 17 Jul 2026 10:30:30 +0300 Subject: [PATCH] Document per_page maximum and silent clamping --- .../rest/using-the-rest-api/using-pagination-in-the-rest-api.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/content/rest/using-the-rest-api/using-pagination-in-the-rest-api.md b/content/rest/using-the-rest-api/using-pagination-in-the-rest-api.md index aadf26371017..abdf7da649ce 100644 --- a/content/rest/using-the-rest-api/using-pagination-in-the-rest-api.md +++ b/content/rest/using-the-rest-api/using-pagination-in-the-rest-api.md @@ -66,6 +66,8 @@ The URLs in the `link` header use query parameters to indicate which page of res If an endpoint supports the `per_page` query parameter, then you can control how many results are returned on a page. For more information about query parameters see [AUTOTITLE](/rest/using-the-rest-api/getting-started-with-the-rest-api#using-query-parameters). +For most endpoints, the maximum value of `per_page` is `100`. If you specify a value greater than the maximum, {% data variables.product.company_short %} does not return an error. Instead, the value is automatically reduced to the maximum, and the response includes no more than the maximum number of results per page. Because the request still succeeds, you may receive fewer results than you expect without any indication that the `per_page` value was reduced. To confirm the default and maximum `per_page` values for an endpoint, see the reference documentation for that endpoint. + For example, this request uses the `per_page` query parameter to return two items per page: ```shell