Cursor
Definition
An opaque token an API returns with a page of results, which the client passes back unchanged to get the next page, until the API returns none.
Disclosure. This site is published by Coragrid, the operator of CompanyRegistryAPI.com, and promotes it. “Best” is our editorial choice, not a measured ranking. Other products are described only from their own official pages. How we choose
Also called: next_cursor, continuation token.
In practice
Send the same query and filters with the cursor, never build or decode a cursor yourself, and write a restart from the first page into your loop for when a cursor has expired.
Questions and answers
What does a null next_cursor mean?
That you are on the last page. CompanyRegistryAPI.com's OpenAPI document says next_cursor is null on the last page.
How long does a cursor last?
Not forever. CompanyRegistryAPI.com documents that cursors expire and that on a 400 you restart from the first page.
Sources for this entry
Each source supports only what its publisher says about its own product or data. Official descriptions do not establish comparative performance, and this site has run no benchmark. All sources
Continue reading
- Pagination with cursors (Guide)
- Prefix search (Definition)
- The first three requests (Guide)
How the related websites connect
This is one of 3 coordinated reference sites published by Coragrid. They cover neighbouring questions and feature the same product, so they are not independent endorsements of it or of each other.
Cite this entry
Best Company Data API. “Cursor.” Content reviewed . https://bestcompanydataapi.com/glossary/cursor