Endpoint
List countries
Countries with upcoming events, with counts per country and city.
GET
https://www.kindredoo.com/api/v1/countriesOnly 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
| Status | Code | Meaning |
|---|---|---|
| 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.