Orgs

List organizations

Changed on

Paginated list of orgs with 30-day release sparklines. Supports ?q= substring search on name/slug. Orgs that have no indexed releases yet are hidden by default; pass ?includeEmpty=true to opt in. The response always carries meta.emptyOrgCount so a UI toggle can show how many are hidden without a second round-trip.

get/orgs

Request

  • Base URL: https://api.releases.sh
  • URL: https://api.releases.sh/orgs
  • Auth: none declared

Query parameters

qstring

Case-insensitive substring match on name or slug.

categorystring

Filter to a single canonical category slug (e.g. ai, devops). Invalid values are ignored (unfiltered). meta.emptyOrgCount is scoped to the same filter.

pageinteger
limitinteger
includeEmptyboolean

Include orgs that have zero indexed releases. Default false — empty orgs are stubs from in-flight discovery or broken parsers and surface as noise on the public catalog.

featuredboolean

Filter to editorially featured orgs only (home-page rail). Default unfiltered.

trackingRequested'1'

Admin-only. Pass 1 to restrict to orgs that have stamped trackingRequestedAt (the self-serve listing owner-demand signal, #1947), ordered most-recent-first. Items still conform to OrgListItemSchema (same envelope as the public list) but carry the additive trackingRequestedAt field and zeroed stats — these are self-serve stub orgs with no processed sources yet. Requires admin bearer auth — a non-admin caller gets a 403, the param is never silently ignored.

Response

Paginated org list

Changes

  • 2abc1553baf2Revision changes
    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • info

      response property items/items/avatarUrl list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property items/items/description list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property items/items/domain list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property items/items/lastActivity list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property items/items/trackingRequestedAt list-of-types was narrowed by removing types null from media type application/json of response 200

  • c3a92b6b6909Revision changes
    • warning

      added the new too_large enum value to the / response property for the response status