Skip to content
Docs · Get an event

Endpoint

Get an event

One upcoming public event by its id or slug.

GEThttps://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

ParameterTypeRequiredDescription
idOrSlugpathstringRequiredThe 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

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.
404not_foundNo such endpoint, or the event is over, unpublished or removed.
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.