Microsoft-graph-docs: What's the default or maximal page size when the $top query parameter is missing?

[HeinPauwelyn]

If the request is paged and you don't added the $top query parameter, is there a default or maximal page size on the request? If yes, how big are they?

---

Document Details

• ID: c7e1ac6d-b2ee-c495-3194-f2895e26945e
• Version Independent ID: 73f817df-a829-e265-c932-7ae8b3f3e918
• Content: Paging Microsoft Graph data in your app - Microsoft Graph
• Content Source: concepts/paging.md
• Product: non-product-specific
• Technology: microsoft-graph
• GitHub Login: @piotrci
• Microsoft Alias: MSGraphDocsVteam

[dkershaw10]

Unfortunately (per the referenced page) there's no consistency across APIs on the default or maximum size. For example, in Azure AD (users, groups, devices etc) the default is 100 and max 999. In Outlook the default is 10 (and I can't even tell you what the max is here).

[msimecek]

Where can developers get this information for individual APIs? For instance I would like to know what's the page size limit for the "List messages" API in Microsoft Graph. The Docs page says:

Depending on the page size and mailbox data, getting messages from a mailbox can incur multiple requests. The default page size is 10 messages. To get the next page of messages, simply apply the entire URL returned in @odata.nextLink to the next get-messages request. This URL includes any query parameters you may have specified in the initial request.

It would be great to have consistency at least in the MS Graph documentation (such as simple table with "default" and "limit" numbers).

[povlhp]

No matter pagesize, your will always have results larger than the largest possible pagesize. So just make robust code, and add the extra while loop so you run as long as you have a valid nextlink.

[Dsiddhesh]

@povlhp can we safely set $top to 100 in our application ?

[Herz3h]

For some reasons the max for sharepoint seems to be 203.....even though I specified $top 999