Pagination
All list endpoints in the JJHub API return paginated results using cursor-based pagination. Each response includes anext_cursor field in the body and a Link header for navigation.
Query Parameters
Both parameters are optional. If omitted, the API returns the first 30 results.
limit exceeds 100, the API clamps it to 100 silently (no error).
Response Body
Every paginated response includes anext_cursor field alongside the result items:
When
next_cursor is null, you have reached the end of the result set.
Response Headers
Link Header
TheLink header is provided for compatibility with tooling that expects RFC 8288 navigation. It contains cursor-based URLs:
Link header includes only the relations that are relevant to the current page:
When
next is absent, you have reached the last page.
Using the
next_cursor field from the response body is the recommended approach. The Link header is provided as a convenience for tools that consume it automatically.Full Example
Request
Response Headers
Response Body
Code Examples
curl
JavaScript / TypeScript
Using the Link Header (compatibility)
Endpoints That Support Pagination
All list endpoints support pagination, including:GET /api/repos/:owner/:repo/issuesGET /api/repos/:owner/:repo/landingsGET /api/repos/:owner/:repo/changesGET /api/repos/:owner/:repo/bookmarksGET /api/repos/:owner/:repo/workflowsGET /api/repos/:owner/:repo/runsGET /api/repos/:owner/:repo/labelsGET /api/repos/:owner/:repo/milestonesGET /api/repos/:owner/:repo/stargazersGET /api/user/reposGET /api/user/starredGET /api/orgs/:org/reposGET /api/orgs/:org/membersGET /api/search/repositoriesGET /api/search/issuesGET /api/search/codeGET /api/search/users
CLI Pagination
Thejjhub CLI handles pagination automatically. Use --limit (short: -L) to control how many results are returned. The default is 30 and the maximum is 100, consistent across all commands.
--json output, the response includes a next_cursor field so scripts can implement manual cursor-based pagination if needed.