Skip to main content
Only POST /statutes/search is paginated. Two request fields control the window, and one response flag tells you when to stop.

Request parameters

Response fields

Each search response includes these top-level fields:
  • results: the array of result objects for this page.
  • total: the count of results returned on this page, not the corpus-wide match count.
  • offset: the offset that was applied.
  • hasMore: true when more results are reachable beyond this page.
total is a per-page count, not a corpus total. There is no field that reports how many sections in the whole corpus match your query. Use hasMore to drive your loop, not arithmetic on total.

How deep you can page

The deepest reachable result is offset + limit. Because offset is capped at 40 (the reranking window), the furthest you can page is offset 40 plus your limit. To reach the last results, request the largest page size:
If you need to survey a jurisdiction more broadly, scope with corpusType and state and run several narrower queries rather than trying to page past the window. Tighter scope also gives more predictable pages.

Page until hasMore is false

This loop walks every reachable page, stopping when hasMore is false or the offset cap is reached.

Rate limits

Stay under per-minute limits while paging in a loop.

Best practices

Scope queries for tighter, more predictable pages.