Taxonomy

List all categories with org and product counts

Changed on

Categories are a fixed taxonomy (CATEGORIES in @buildinternet/releases-core/categories), so the response always includes every slug — including ones with zero members. orgCount and productCount are computed against organizations_public (excludes on_demand and soft-deleted orgs). name / description / aliases come from the optional categories metadata overlay; clients render their own fallback display name when no override is set.

get/categories

Request

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

Response

Full category list, one row per canonical slug

slug'ai' | 'cloud' | 'commerce' | 'crm' | 'database' | 'design' | 'developer-tools' | 'devops' | 'finance' | 'framework' | 'infrastructure' | 'observability' | 'productivity' | 'security' required
namestring required
descriptionstring nullable required
aliasesstring[] required
orgCountinteger required
productCountinteger required

Changes

  • 2abc1553baf2Revision changes
    • breaking

      the response property / became nullable for the status

    • breaking

      added subschema #1 subschema #2 to the // response property oneOf list for the response status

    • info

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

    • info

      removed subschema #1 subschema #2 from the // response property oneOf list for the response status