---
search:
  tags:
    - Categories
    - GET
seo:
  description: >-
    Any signed in user. Returns every category with the number of medicines
    filed under… Reference for the GET /api/v1/categories endpoint in the
    PharmaFlow API.
sidebar:
  label: List the category catalogue
  badge: GET
title: List the category catalogue
type: openapi-operation
---
Any signed in user. Returns every category with the number of medicines filed under it. The count comes from a live join, so an empty category reports zero, not a dropped row.

`GET /api/v1/categories`

**Responses**

- `200` — The category catalogue with usage counts
- `401` — Not authenticated

Response example, 200:

```json
{
  "items": [
    {
      "slug": "string",
      "name": "string",
      "medicine_count": -9007199254740991
    }
  ],
  "total": -9007199254740991
}
```