Skip to content
Docs · List categories

Endpoint

List categories

Every event category, with the number of upcoming events in each.

GEThttps://www.kindredoo.com/api/v1/categories

Use a category `id` as the `category` filter on GET /events.

Needs Authorization: Bearer <key>. Counts as one request against your per-minute and monthly limits.

Parameters

This endpoint takes no parameters.

Request

curl "https://www.kindredoo.com/api/v1/categories" \
  -H "Authorization: Bearer $KINDRED_API_KEY"

Response

200Response
{
  "data": [
    {
      "id": "music",
      "label": "Music",
      "upcoming_events": 42
    },
    {
      "id": "art",
      "label": "Art",
      "upcoming_events": 7
    },
    {
      "id": "food",
      "label": "Food",
      "upcoming_events": 13
    }
  ]
}

Every response also carries X-RateLimit-* headers and an ETag. See rate limits.

Errors

StatusCodeMeaning
401missing_api_keyNo `Authorization: Bearer <key>` header.
401invalid_api_keyThe key is unknown, mistyped or revoked.
403account_unavailableThe account that owns the key is suspended or closed.
403key_pausedThe account holds more active keys than its plan allows (e.g. after Pro ended), so its least recently used keys are paused.
429rate_limitedToo many requests this minute for this key.
429quota_exceededThe account used its monthly requests.
500server_errorSomething failed on our side.

Start building with Kindred events

Create a free key in a minute with your Kindred account. Upgrade to Pro when you go commercial.