# Docs: state the maximum page\_size for list endpoints

**URL:** <https://forum.frame.io/t/docs-state-the-maximum-page-size-for-list-endpoints/3479>\
**Category:** Feedback\
**Created:** [August 1, 2026, 7:48pm UTC](https://forum.frame.io/t/docs-state-the-maximum-page-size-for-list-endpoints/3479 "2026-08-01T19:48:05Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![krlrzv](https://yyz1.discourse-cdn.com/flex035/user_avatar/forum.frame.io/krlrzv/32/439_2.png) [@krlrzv](https://forum.frame.io/u/krlrzv)\
**Post date:** [August 1, 2026, 7:48pm UTC](https://forum.frame.io/t/docs-state-the-maximum-page-size-for-list-endpoints/3479/1 "2026-08-01T19:48:06Z")

</div>

`page_size` documents a default of 50, but the schema does not state a maximum. Clients that size their prefetch window have to guess, and guessing wrong is either wasted round-trips (too small) or a rejected request (too large).

Requested: an explicit maximum in the parameter schema/docs for `page_size` across the list endpoints.

---

<div class="post-metadata">

**Author:** ![rosiec](https://yyz1.discourse-cdn.com/flex035/user_avatar/forum.frame.io/rosiec/32/518_2.png) [@rosiec](https://forum.frame.io/u/rosiec)\
**Post date:** [August 5, 2026, 4:50am UTC](https://forum.frame.io/t/docs-state-the-maximum-page-size-for-list-endpoints/3479/2 "2026-08-05T04:50:47Z")

</div>

Hi @krlrzv,

Thanks for bringing this up. Before going into detail, I want to make sure we’re referencing the same source, as I’ll be pulling examples from the schema defined in our OpenAPI spec **[here](https://api.frame.io/v4/openapi.json)**

Looking it over, each list endpoint’s `page_size` parameter points to one of two shared schemas, which are `RequestPageSize` or `AssetRequestPageSize`. Both define an explicit `maximum`.

`RequestPageSize` sets a maximum of 100, and `AssetRequestPageSize` sets a maximum of 500.

Both also share a `default` of 50 when no `page_size` is passed, which is likely why you were seeing 50 come back successfully while higher values behaved differently across endpoints.

One thing I will say is that even though the ranges are stated correctly on the individual endpoints in the **[API Reference](https://next.developer.frame.io/platform/api-reference/account-permissions/index)**, the Pagination section in our Getting Started guide states the maximum as 100, which, based on the above, is partially incorrect. So thank you for flagging this! I’ll make sure to get this corrected.