---
title: List all categories with org and product counts
description: >-
  Categories are a fixed taxonomy (CATEGORIES in
  @buildinternet/releases-core/categories), so the response always includes
  every slug — including ones with zero members.
---
# List all categories with org and product counts

`GET https://api.releases.sh/v1/categories`

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.

**Auth:** optional Bearer token.

**Responses**

- `200` Full category list, one row per canonical slug

Full request and response schemas: [OpenAPI 3.1 spec](https://api.releases.sh/v1/openapi.json).