v50

latestOpenAPI 3.1.0Apache-2.0raw.githubusercontent.com2026-08-01147180956.9 KB

Catalog

List Catalog

List a keyset page of browsable catalog entries (search/filter aware).

The catalog holds thousands of entries, so this is cursor-paginated like GET /apis: follow next_cursor until has_more is false. catalog_total/registered_count/outdated_count count the whole manifest, not the page, so the Discover status row stays stable while scrolling.

get/catalog

Query parameters

qstring nullable

registered_onlyboolean

unregistered_onlyboolean

outdated_onlyboolean

cursorstring nullable

limitinteger

Response

Successful Response

catalog_totalinteger required

Total entries in the whole manifest (pre-filter, pre-page).

has_moreboolean

Whether another page follows.

manifest_age_secondsinteger nullable

Age of the cached manifest in seconds, or null when the cache is empty.

next_cursorstring nullable

Opaque keyset cursor for the next page (null when done).

outdated_countinteger

Count of whole-manifest registered entries with an upstream update available.

registered_countinteger required

Count of whole-manifest entries already imported locally.

Example response

{
  "catalog_total": 5231,
  "data": [],
  "has_more": true,
  "manifest_age_seconds": 3600,
  "next_cursor": "eyJpZCI6ICJzdHJpcGUuY29tIn0=",
  "registered_count": 12
}