> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shoal.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Get All Categories

> List all event categories and subcategories

Returns every distinct event category and subcategory pair used across radar and signal events. Use the returned `eventCategory` values as filter parameters when calling the `byCategory` endpoints. This is useful for building category filter dropdowns or understanding the taxonomy of events Shoal tracks.

## Query Parameters

None.

### Request

```bash cURL theme={null}
curl -X GET "https://api.shoal.xyz/v1/categories" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Response (200)

```json theme={null}
{
  "data": [
    {
      "eventCategory": "partnership",
      "eventSubcategory": "acquisition"
    },
    {
      "eventCategory": "development",
      "eventSubcategory": "launch"
    }
  ]
}
```

Returns all distinct `eventCategory` / `eventSubcategory` pairs across both radar and signal events, sorted alphabetically.

Use the returned `eventCategory` values as the `category` parameter when calling [`/v1/radar/byCategory`](/api-reference/radar/by-category) or [`/v1/signal/byCategory`](/api-reference/signal/by-category).