> For the complete documentation index, see [llms.txt](https://mava.gitbook.io/mava-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mava.gitbook.io/mava-docs/webhooks-and-api/api/get-categories.md).

# Get Categories

Retrieves a list of all active categories for the authenticated client.

### Endpoint

```
GET /api/categories
```

### Authentication

* Requires API token authentication
* Requires the Scale plan or above (see [API](/mava-docs/webhooks-and-api/api.md))
* Subject to rate limiting

### Response

**Success (200 OK)**

```json
{
  "categories": [
    {
      "_id": "string",
      "name": "string"
    }
  ]
}
```

**Unauthorized (401)**

Returned when the API key is missing or invalid.

**Plan too low (403)**

```json
{
  "text": "API access requires the Scale plan or higher"
}
```

**Error (500 Internal Server Error)**

```json
{
  "error": "Internal server error"
}
```