diff --git a/source/rest-v2.html.md b/source/rest-v2.html.md index 8e360a2f131..d7f800fb848 100644 --- a/source/rest-v2.html.md +++ b/source/rest-v2.html.md @@ -33,9 +33,9 @@ API keys are passed via the `Authorization` header as demonstrated in the code s Many endpoints in the API support pagination to help manage large result sets. When using pagination, the following query parameters are available: | Parameter | Type | Description | -| --------- | ------- | ------------------------------------------------------ | +| --------- | ------- |--------------------------------------------------------| | page | Integer | Page number to retrieve (default: returns all results) | -| per_page | Integer | Number of items per page (default: 25, max: 100) | +| per_page | Integer | Number of items per page (default: 1000, max: 1000) | When pagination is used, the following headers are included in the response: @@ -46,6 +46,12 @@ When pagination is used, the following headers are included in the response: | X-Next-Page | Next page number (if available) | | X-Prev-Page | Previous page number (if available) | +If no pagination parameters are provided, the API will return all results in a single response, up to a maximum of 1000 items, and include the following header in the response: + +| Header | Description | +|--------------------|--------------------------------------------------------------| +| X-Result-Truncated | Set to `true` if there are more items than the maximum allowed | + ### API Path structure The base path of an API request is: `https://api.publitas.com/v2/`