API reference
Endpoints
Version 1 of the Kindred Events API. Every endpoint is a GET that returns JSON.
BASE
https://www.kindredoo.com/api/v1- GET
/eventsUpcoming public events, soonest first, with filters and pagination. - GET
/events/{idOrSlug}One upcoming public event by its id or slug. - GET
/categoriesEvery event category, with the number of upcoming events in each. - GET
/countriesCountries with upcoming events, with counts per country and city. - GET
/openapi.jsonThis API as an OpenAPI 3.1 document. No key needed.
Conventions
- Successful responses wrap results in
data; lists addpagination. 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
404on an id you stored means it's over or was removed. - Responses carry
ETagandCache-Control: private, max-age=60, stale-while-revalidate=300. CORS allows any origin forGET; other methods answer405 method_not_allowed.
The event object
| Field | Description |
|---|---|
| id | Stable id. Use it (or slug) with GET /events/{idOrSlug}. |
| slug | URL slug for verified events (null for Kindred-curated ones). |
| title | Event name as the organiser writes it. |
| category / category_label | One of the ids from GET /categories, and its display label. |
| start / end | ISO 8601 with the event's own UTC offset. end may be null. |
| time_known | false when only the date is known: show the date without a time. |
| timezone | IANA zone of the event, e.g. Africa/Lagos. |
| venue, city, region, country, country_name | Where it happens. country is ISO 3166-1 alpha-2; region is null when unknown. |
| summary | A short description in our own words (may be null). |
| price | Price as the organiser states it (may be null). |
| images.card / images.og | Pictures 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_url | The event on Kindred: link here so people can go with friends. |
| ticket_url / official_url | Official tickets, and the organiser page the event was verified on. |
| source | curated (by the Kindred team) or discovered (found and checked on the organiser's page). |
| updated_at | When 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.