Skip to content
Docs · Overview

API reference

Endpoints

Version 1 of the Kindred Events API. Every endpoint is a GET that returns JSON.

BASEhttps://www.kindredoo.com/api/v1

Conventions

  • Successful responses wrap results in data; lists add pagination. Errors are { "error": { "code", "message" } }.
  • Dates are ISO 8601. Field names are snake_case. Unknown query parameters are ignored.
  • Only public, published, upcoming events are returned. An event drops out once it ends; a 404 on an id you stored means it's over or was removed.
  • Responses carry ETag and Cache-Control: private, max-age=60, stale-while-revalidate=300. CORS allows any origin for GET; other methods answer 405 method_not_allowed.

The event object

FieldDescription
idStable id. Use it (or slug) with GET /events/{idOrSlug}.
slugURL slug for verified events (null for Kindred-curated ones).
titleEvent name as the organiser writes it.
category / category_labelOne of the ids from GET /categories, and its display label.
start / endISO 8601 with the event's own UTC offset. end may be null.
time_knownfalse when only the date is known: show the date without a time.
timezoneIANA zone of the event, e.g. Africa/Lagos.
venue, city, region, country, country_nameWhere it happens. country is ISO 3166-1 alpha-2; region is null when unknown.
summaryA short description in our own words (may be null).
pricePrice as the organiser states it (may be null).
images.card / images.ogPictures hosted by Kindred. Discovered events: a 1200x675 card and a 1200x630 social picture. Curated events: the event's picture (or its category cover) in both.
kindred_urlThe event on Kindred: link here so people can go with friends.
ticket_url / official_urlOfficial tickets, and the organiser page the event was verified on.
sourcecurated (by the Kindred team) or discovered (found and checked on the organiser's page).
updated_atWhen we last changed or re-checked the event.
200Event object
{
  "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"
}

The full machine-readable description is the OpenAPI 3.1 spec.