Endpoint
List categories
Every event category, with the number of upcoming events in each.
GET
https://www.kindredoo.com/api/v1/categoriesUse 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
| Status | Code | Meaning |
|---|---|---|
| 401 | missing_api_key | No `Authorization: Bearer <key>` header. |
| 401 | invalid_api_key | The key is unknown, mistyped or revoked. |
| 403 | account_unavailable | The account that owns the key is suspended or closed. |
| 403 | key_paused | The account holds more active keys than its plan allows (e.g. after Pro ended), so its least recently used keys are paused. |
| 429 | rate_limited | Too many requests this minute for this key. |
| 429 | quota_exceeded | The account used its monthly requests. |
| 500 | server_error | Something 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.