Skip to content
Docs · List countries

Endpoint

List countries

Countries with upcoming events, with counts per country and city.

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

Only countries that have at least one upcoming public event are listed, sorted by name.

Needs Authorization: Bearer <key>. Counts as one request against your per-minute and monthly limits.

Parameters

This endpoint takes no parameters.

Request

curl "https://www.kindredoo.com/api/v1/countries" \
  -H "Authorization: Bearer $KINDRED_API_KEY"

Response

200Response
{
  "data": [
    {
      "code": "NG",
      "name": "Nigeria",
      "upcoming_events": 18,
      "cities": [
        {
          "name": "Lagos",
          "upcoming_events": 14
        },
        {
          "name": "Abuja",
          "upcoming_events": 4
        }
      ]
    }
  ]
}

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.
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.