Skip to main content
GET
/
v1
/
categories
Get All Categories
curl --request GET \
  --url https://api.shoal.xyz/v1/categories \
  --header 'Authorization: Bearer <token>'
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

cURL
curl -X GET "https://api.shoal.xyz/v1/categories" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response (200)

{
  "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 or /v1/signal/byCategory.