Endpoint
List events
Upcoming public events, soonest first, with filters and pagination.
GET
https://www.kindredoo.com/api/v1/eventsReturns published, upcoming events that are on at some point between `from` and `to` (by default now to 90 days ahead). An event that has started but not ended yet is included. Results are sorted by start time.
Needs Authorization: Bearer <key>. Counts as one request against your per-minute and monthly limits.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| countryquery | string | Optional | Two-letter ISO 3166-1 country code. |
| cityquery | string | Optional | City name or id, case-insensitive ("Lagos", "buenos-aires"). |
| categoryquery | enum | Optional | One category id from GET /categories.music · art · food · sport · comedy · culture · market · festival · tech · community |
| fromquery | string | Optional | Start of the window: an ISO 8601 date (2026-12-01, the start of that day UTC) or a date-time with a zone (2026-12-01T18:00:00+01:00). Defaults to now; earlier values are treated as now. |
| toquery | string | Optional | End of the window: an ISO 8601 date or a date-time with a zone. A date alone means the end of that day (UTC). Defaults to 90 days after `from`; at most 366 days after it. |
| qquery | string | Optional | Text search (case-insensitive, 2 to 100 characters) in the title, description, venue and organiser. |
| pagequery | integer | Optional | Page number, 1 to 10,000.Default: 1 |
| limitquery | integer | Optional | Results per page, 1 to 100.Default: 20 |
| sortquery | enum | Optional | `start` (soonest first) or `-start` (latest first).start · -startDefault: start |
Request
curl "https://www.kindredoo.com/api/v1/events?country=NG&category=music&limit=10" \
-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"
}
],
"pagination": {
"page": 1,
"limit": 10,
"total": 1,
"total_pages": 1,
"has_more": false
},
"filters": {
"country": "NG",
"city": null,
"category": "music",
"q": null,
"from": "2026-11-18T12:00:00.000Z",
"to": "2027-02-16T12:00:00.000Z",
"sort": "start"
},
"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 |
|---|---|---|
| 400 | invalid_parameter | A query parameter is missing, malformed or out of range. |
| 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.