OneNote pages API doesn't return pages in sect

Question

I'm using the OneNote REST API (documented here). According to the documentation, calling the 'pages' endpoint returns "all the OneNote pages across all notebooks ..."

The endpoint I'm calling: https://www.onenote.com/api/beta/me/notes/pages

This seems to work in most / some cases, but pages which are part of sections which are themselves placed in section groups aren't returned.

Does anyone know if I'm doing something wrong on my side? Could it be a bug in the API or its documentation?

Answer 1

The OneNote API returns, by default, only 20 pages at a time. Using OData operators like $top and $skip, you can walk through all of the results of the API. We believe that the pages you're not seeing may be the result of not walking through all of the page results. The page result will also have a "next link" included to make this easier.