Endpoint
Get an event
One upcoming public event by its id or slug.
GET
https://www.kindredoo.com/api/v1/events/{idOrSlug}Look an event up by the `id` or `slug` from a list response. Events that are over, unpublished or removed answer 404 `not_found`.
Needs Authorization: Bearer <key>. Counts as one request against your per-minute and monthly limits.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| idOrSlugpath | string | Required | The event's `id` or `slug`. |
Request
curl "https://www.kindredoo.com/api/v1/events/futurefest-26-convergence-lagos-2026-12-11" \
-H "Authorization: Bearer $KINDRED_API_KEY"Response
200Response
{
"data": {
"id": "dx-mi3k2a-7f2q1c",
"slug": "futurefest-26-convergence-lagos-2026-12-11",
"title": "FutureFest '26 Convergence",
"category": "festival",
"category_label": "Festivals",
"start": "2026-12-11T16:00:00+01:00",
"end": "2026-12-20T23:00:00+01:00",
"time_known": true,
"timezone": "Africa/Lagos",
"venue": "Eko Atlantic",
"city": "Lagos",
"region": null,
"country": "NG",
"country_name": "Nigeria",
"summary": "Ten days of music, tech talks and art installations by the Atlantic.",
"price": "From ₦25,000",
"images": {
"card": "https://www.kindredoo.com/events/futurefest-26-convergence-lagos-2026-12-11/image/card-k3f9.webp",
"og": "https://www.kindredoo.com/events/futurefest-26-convergence-lagos-2026-12-11/image/og-k3f9.jpg"
},
"kindred_url": "https://www.kindredoo.com/events/futurefest-26-convergence-lagos-2026-12-11",
"ticket_url": "https://app.futurefest.live/tickets",
"official_url": "https://app.futurefest.live/",
"source": "discovered",
"updated_at": "2026-11-16T14:53:14.000Z"
},
"attribution": "Powered by Kindred (https://www.kindredoo.com)"
}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. |
| 404 | not_found | No such endpoint, or the event is over, unpublished or removed. |
| 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.