Skip to content
Docs · List events

Endpoint

List events

Upcoming public events, soonest first, with filters and pagination.

GEThttps://www.kindredoo.com/api/v1/events

Returns 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

ParameterTypeRequiredDescription
countryquerystringOptionalTwo-letter ISO 3166-1 country code.
cityquerystringOptionalCity name or id, case-insensitive ("Lagos", "buenos-aires").
categoryqueryenumOptionalOne category id from GET /categories.music · art · food · sport · comedy · culture · market · festival · tech · community
fromquerystringOptionalStart 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.
toquerystringOptionalEnd 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.
qquerystringOptionalText search (case-insensitive, 2 to 100 characters) in the title, description, venue and organiser.
pagequeryintegerOptionalPage number, 1 to 10,000.Default: 1
limitqueryintegerOptionalResults per page, 1 to 100.Default: 20
sortqueryenumOptional`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

StatusCodeMeaning
400invalid_parameterA query parameter is missing, malformed or out of range.
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.
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.