The calisthenics world, as an API
Parks, gyms, competitions, meetups and coaches from Caliplaces, moderated by our team and kept fresh by the community. Simple REST, JSON, one API key.
Quickstart
- Sign in with your Caliplaces account and create a project.
- Create an API key in the project. Copy it now: it is shown only once.
- Keep it on your server, for example in a CALIPLACES_API_KEY environment variable, and call the API:
curl "https://api.caliplaces.com/open/v1/places?city=Prague&limit=5" \
-H "Authorization: Bearer $CALIPLACES_API_KEY"Every response is JSON. Lists come as {"data": [...], "pagination": {...}}, single items as the object itself. The base URL is https://api.caliplaces.com/open/v1.
Authentication
Send your key in the Authorization header as Bearer cp_live_... on every request. Keys are secrets: call the API from your server and never ship a key in a website, mobile app or public repository. If a key leaks, revoke it in the dashboard and create a new one. Revoking takes effect immediately.
Each key carries scopes. New keys get all of them unless you pick fewer:
| Scope | Allows |
|---|---|
places:read | GET /places, /places/{id}, /cities |
events:read | GET /events, /events/{id} |
coaches:read | GET /coaches, /coaches/{id} |
Limits
The free plan allows 5 requests a minute and 1,000 a month, shared by all free projects of your account. It is meant for building and testing. A project on pay as you go gets 60 requests a minute of its own and no monthly cap, and each successful call costs 0.002 credits (€2 per 1,000) from your prepaid balance. Failed calls cost nothing. Every response tells you where you stand:
| Header | Meaning |
|---|---|
X-RateLimit-Limit | Requests allowed per minute |
X-RateLimit-Remaining | Requests left in the current minute |
X-Quota-Limit | Free plan: requests allowed per calendar month (UTC) |
X-Quota-Remaining | Free plan: requests left this month |
X-Quota-Reset | Free plan: when the monthly allowance starts over (RFC 3339) |
X-Credits-Remaining | Pay as you go: credits left after this call, e.g. 24.998000 |
Retry-After | On 429: seconds to wait before trying again |
Over a limit you get 429 with a Retry-After header. Requests we answer with a 5xx error never count against your limits.
Errors
Errors are JSON with a stable machine-readable code and a human message. Branch on the code, never on the message:
{
"error": {
"code": "rate_limited",
"message": "Too many requests. Retry after the time in the Retry-After header."
}
}| Status | Code | Meaning |
|---|---|---|
| 400 | invalid_parameter | A query parameter is missing its pair, out of range or malformed. The message names it. |
| 401 | missing_api_key | No Authorization: Bearer header. |
| 401 | invalid_api_key | The key does not exist or is mistyped. |
| 401 | revoked_api_key | The key was revoked in the dashboard. |
| 401 | expired_api_key | The key passed its expiry date. |
| 402 | insufficient_credits | Pay as you go: the credit balance is too low for this call. Top up in the dashboard. |
| 402 | spend_cap_reached | Pay as you go: your monthly spending cap is reached. Raise it or wait for the 1st (UTC). |
| 403 | insufficient_scope | The key lacks the scope this endpoint needs. |
| 403 | project_suspended | The project was suspended. Write to us. |
| 403 | account_suspended | The Caliplaces account that owns the project is not active. |
| 404 | not_found | No such item, or it is not public. |
| 405 | method_not_allowed | The API is read-only: use GET. |
| 429 | rate_limited | Over the per-minute limit. Wait for Retry-After seconds. |
| 429 | monthly_quota_exceeded | The month’s requests are used up. Resets on the 1st (UTC). |
| 429 | too_many_failed_attempts | Too many requests with bad keys from your address. |
| 500 | internal_error | Our fault. Not counted against your limits. |
| 503 | service_unavailable | Briefly unavailable. Retry with backoff. Not counted. |
Pagination
Lists take limit (1 to 50, default 20) and offset (up to 1,000). Keep going while pagination.has_more is true. To go deeper, narrow the request instead: filter by area (lat/lng or bbox), city or updated_since. To keep a copy in sync, fetch only what changed with updated_since.
Attribution and fair use
- Show Data by Caliplaces wherever you display the data, and link each place, event or coach to its
url. - Photos are watermarked. Show them as they are: don’t crop out or cover the watermark.
- Don’t use the API to rebuild Caliplaces or resell its data as a dataset.
- Some addresses are derived from OpenStreetMap. Where you show an address, also show © OpenStreetMap contributors (ODbL).
- Cache data for at most 30 days, then refresh or delete it, so removed and corrected listings disappear from your app too.
- The full rules are in the Open API Terms of Use, which you accept when you create a project.
- Questions or a use case that needs more? Write to developers@caliplaces.com.
Versioning
This is v1. We only add to it: new endpoints, new optional parameters and new fields in responses, so ignore fields you don’t know. Anything that would break your code ships as v2 alongside v1, with at least 12 months’ notice before v1 is retired.
Places
List places
Calisthenics parks and gyms, moderated by the Caliplaces team. Every filter is optional and they combine. With lat/lng the list is nearest first and each place carries distance_meters; otherwise it is best rated first.
Parameters
| Name | Type | Description |
|---|---|---|
q | string | Search names and addresses (2-100 characters) |
lat | number | Latitude of the centre point (needs lng) |
lng | number | Longitude of the centre point (needs lat) |
radius_km | number | Search radius around lat/lng in km, up to 100. Default: 10. |
bbox | string | Bounding box min_lng,min_lat,max_lng,max_lat, at most 5 degrees each way |
city | string | Exact city name, case-insensitive |
country | string | Exact country name, case-insensitive |
type | string | park or gym |
min_rating | number | Only places rated at least this (1-5) |
updated_since | string | Only places changed since this RFC 3339 time, for syncing |
limit | integer | Page size, 1-50. Default: 20. |
offset | integer | Items to skip, up to 1000. Default: 0. |
Request
curl "https://api.caliplaces.com/open/v1/places?lat=50.0755&lng=14.4378&radius_km=5&limit=10" \
-H "Authorization: Bearer $CALIPLACES_API_KEY"Response 200 · PlaceList
dataPlace[]iduuidnamestringaddressstringamenitiesstring[]citystringnullableconditionstringok, or a reported problem with the place. One of: "ok", "under_construction", "temporarily_closed", "permanently_closed", "damaged".
countrystringnullableCountry as stored by the place's author, usually the English name.
created_attimestampdescriptionstringnullabledistance_metersnumbernullableOnly set when the request was filtered by lat/lng.
locationLocationlatitudenumberlongitudenumberopening_hoursstringnullablephotosstring[]Full-size photo URLs, watermarked.
ratingRatingnullableaveragenumbercountintegertagsstring[]thumbnail_urlstringnullabletypestringOne of: "park", "gym".
updated_attimestampurlstringThe place's page on caliplaces.com. Link to it when you show the data.
websitestringnullablepaginationPaginationhas_morebooleanlimitintegeroffsetinteger
Example response
{
"data": [
{
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name": "Letná Street Workout Park",
"address": "Letenské sady, 170 00 Praha 7",
"amenities": [
"string"
],
"city": "Prague",
"condition": "ok",
"country": "Czech Republic",
"created_at": "2026-10-20T09:30:00Z",
"description": null,
"distance_meters": 420.5,
"location": {
"latitude": 50.0755,
"longitude": 14.4378
},
"opening_hours": null,
"photos": [
"string"
],
"rating": {
"average": 4.6,
"count": 38
},
"tags": [
"string"
],
"thumbnail_url": null,
"type": "park",
"updated_at": "2026-10-20T09:30:00Z",
"url": "https://www.caliplaces.com/place/7c9e6679-7425-40de-944b-e07fc1f90ae7",
"website": null
}
],
"pagination": {
"has_more": true,
"limit": 20,
"offset": 0
}
}Get a place
Parameters
| Name | Type | Description |
|---|---|---|
idpathrequired | string | Place id |
Request
curl "https://api.caliplaces.com/open/v1/places/7c9e6679-7425-40de-944b-e07fc1f90ae7" \
-H "Authorization: Bearer $CALIPLACES_API_KEY"Response 200 · Place
iduuidnamestringaddressstringamenitiesstring[]citystringnullableconditionstringok, or a reported problem with the place. One of: "ok", "under_construction", "temporarily_closed", "permanently_closed", "damaged".
countrystringnullableCountry as stored by the place's author, usually the English name.
created_attimestampdescriptionstringnullabledistance_metersnumbernullableOnly set when the request was filtered by lat/lng.
locationLocationlatitudenumberlongitudenumberopening_hoursstringnullablephotosstring[]Full-size photo URLs, watermarked.
ratingRatingnullableaveragenumbercountintegertagsstring[]thumbnail_urlstringnullabletypestringOne of: "park", "gym".
updated_attimestampurlstringThe place's page on caliplaces.com. Link to it when you show the data.
websitestringnullable
Example response
{
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name": "Letná Street Workout Park",
"address": "Letenské sady, 170 00 Praha 7",
"amenities": [
"string"
],
"city": "Prague",
"condition": "ok",
"country": "Czech Republic",
"created_at": "2026-10-20T09:30:00Z",
"description": null,
"distance_meters": 420.5,
"location": {
"latitude": 50.0755,
"longitude": 14.4378
},
"opening_hours": null,
"photos": [
"string"
],
"rating": {
"average": 4.6,
"count": 38
},
"tags": [
"string"
],
"thumbnail_url": null,
"type": "park",
"updated_at": "2026-10-20T09:30:00Z",
"url": "https://www.caliplaces.com/place/7c9e6679-7425-40de-944b-e07fc1f90ae7",
"website": null
}List cities
Cities with at least one place, most places first. Use a city with GET /places?city=&country=, or its location with lat/lng.
Parameters
| Name | Type | Description |
|---|---|---|
country | string | Exact country name, case-insensitive |
limit | integer | Page size, 1-50. Default: 20. |
offset | integer | Items to skip, up to 1000. Default: 0. |
Request
curl "https://api.caliplaces.com/open/v1/cities?country=Czech%20Republic" \
-H "Authorization: Bearer $CALIPLACES_API_KEY"Response 200 · CityList
dataCity[]citystringcountrystringlocationLocationCentre of the city's places, handy for a map or a nearby search.
latitudenumberlongitudenumberplace_countintegerpaginationPaginationhas_morebooleanlimitintegeroffsetinteger
Example response
{
"data": [
{
"city": "Prague",
"country": "Czech Republic",
"location": {
"latitude": 50.0755,
"longitude": 14.4378
},
"place_count": 42
}
],
"pagination": {
"has_more": true,
"limit": 20,
"offset": 0
}
}Events
List events
Public competitions and meetups, soonest first. By default only events that have not ended yet; pass from to look further back.
Parameters
| Name | Type | Description |
|---|---|---|
kind | string | competition or meetup |
place_id | string | Only events at this place |
from | string | Only events still running at or after this RFC 3339 time. Defaults to now. |
to | string | Only events starting at or before this RFC 3339 time |
lat | number | Latitude of the centre point (needs lng) |
lng | number | Longitude of the centre point (needs lat) |
radius_km | number | Search radius around lat/lng in km, up to 100. Default: 10. |
limit | integer | Page size, 1-50. Default: 20. |
offset | integer | Items to skip, up to 1000. Default: 0. |
Request
curl "https://api.caliplaces.com/open/v1/events?kind=competition&limit=10" \
-H "Authorization: Bearer $CALIPLACES_API_KEY"Response 200 · EventList
dataEvent[]iduuidnamestringcategoriesEventCategory[]namestringcapacityintegernullabledescriptionstringnullablepriceMoneynullableEntry fee. Null when entry is free or the price is not set.
amount_minorintegercurrencystringcover_urlstringnullabledescriptionstringnullabledistance_metersnumbernullableends_attimestampnullablekindstringOne of: "competition", "meetup".
organizerOrganizernullablenamestringhandlestringnullablelogo_urlstringnullablestarts_attimestampnullablestatusstringfinalized = results are final. One of: "published", "finalized".
taglinestringnullabletimezonestringIANA time zone the event is held in, for displaying local times.
updated_attimestampurlstringvenueVenuenamestringnullableaddressstringnullablelocationLocationnullablelatitudenumberlongitudenumberplace_iduuidnullablepaginationPaginationhas_morebooleanlimitintegeroffsetinteger
Example response
{
"data": [
{
"id": "3f2b8c1e-5d4a-4b7c-9e2f-1a2b3c4d5e6f",
"name": "Prague Freestyle Battle 2026",
"categories": [
{
"name": null,
"capacity": null,
"description": null,
"price": null
}
],
"cover_url": null,
"description": null,
"distance_meters": 0,
"ends_at": null,
"kind": "competition",
"organizer": {
"name": "Prague Street Workout",
"handle": "prague-sw",
"logo_url": null
},
"starts_at": null,
"status": "published",
"tagline": null,
"timezone": "Europe/Prague",
"updated_at": "2026-10-20T09:30:00Z",
"url": "https://www.caliplaces.com/event/2f1c9a8e-7b6d-4c3e-9f0a-1b2c3d4e5f60",
"venue": {
"name": "Letná Street Workout Park",
"address": null,
"location": {
"latitude": null,
"longitude": null
},
"place_id": null
}
}
],
"pagination": {
"has_more": true,
"limit": 20,
"offset": 0
}
}Get an event
Parameters
| Name | Type | Description |
|---|---|---|
idpathrequired | string | Event id |
Request
curl "https://api.caliplaces.com/open/v1/events/2f1c9a8e-7b6d-4c3e-9f0a-1b2c3d4e5f60" \
-H "Authorization: Bearer $CALIPLACES_API_KEY"Response 200 · Event
iduuidnamestringcategoriesEventCategory[]namestringcapacityintegernullabledescriptionstringnullablepriceMoneynullableEntry fee. Null when entry is free or the price is not set.
amount_minorintegercurrencystringcover_urlstringnullabledescriptionstringnullabledistance_metersnumbernullableends_attimestampnullablekindstringOne of: "competition", "meetup".
organizerOrganizernullablenamestringhandlestringnullablelogo_urlstringnullablestarts_attimestampnullablestatusstringfinalized = results are final. One of: "published", "finalized".
taglinestringnullabletimezonestringIANA time zone the event is held in, for displaying local times.
updated_attimestampurlstringvenueVenuenamestringnullableaddressstringnullablelocationLocationnullablelatitudenumberlongitudenumberplace_iduuidnullable
Example response
{
"id": "3f2b8c1e-5d4a-4b7c-9e2f-1a2b3c4d5e6f",
"name": "Prague Freestyle Battle 2026",
"categories": [
{
"name": "Freestyle Men",
"capacity": 32,
"description": null,
"price": {
"amount_minor": 1500,
"currency": "eur"
}
}
],
"cover_url": null,
"description": null,
"distance_meters": 0,
"ends_at": null,
"kind": "competition",
"organizer": {
"name": "Prague Street Workout",
"handle": "prague-sw",
"logo_url": null
},
"starts_at": null,
"status": "published",
"tagline": null,
"timezone": "Europe/Prague",
"updated_at": "2026-10-20T09:30:00Z",
"url": "https://www.caliplaces.com/event/2f1c9a8e-7b6d-4c3e-9f0a-1b2c3d4e5f60",
"venue": {
"name": "Letná Street Workout Park",
"address": null,
"location": {
"latitude": 50.0755,
"longitude": 14.4378
},
"place_id": null
}
}Coaches
List coaches
Coaches with an active offering: in person at their home place, online, or both. With lat/lng only in-person coaches near the point are listed, nearest first; otherwise best rated first.
Parameters
| Name | Type | Description |
|---|---|---|
q | string | Search names, titles and handles (2-100 characters) |
lat | number | Latitude of the centre point (needs lng) |
lng | number | Longitude of the centre point (needs lat) |
radius_km | number | Search radius around lat/lng in km, up to 100. Default: 10. |
place_id | string | Only coaches whose home place is this one |
online | boolean | true = only coaches offering online coaching |
limit | integer | Page size, 1-50. Default: 20. |
offset | integer | Items to skip, up to 1000. Default: 0. |
Request
curl "https://api.caliplaces.com/open/v1/coaches?lat=50.0755&lng=14.4378&radius_km=10" \
-H "Authorization: Bearer $CALIPLACES_API_KEY"Response 200 · CoachList
dataCoach[]iduuidnamestringcertifiedbooleancitystringnullablecoaching_modestringin_person = at their home place, online = remote coaching, hybrid = both. One of: "in_person", "online", "hybrid".
cover_urlstringnullabledescriptionstringdistance_metersnumbernullableexperience_levelstringnullablebeginner, intermediate, advanced or as set by the coach.
handlestringhome_placePlaceRefnullableThe park the coach trains clients at in person, if any.
iduuidnamestringlocationLocationnullablelatitudenumberlongitudenumberphoto_urlstringnullableratingRatingnullableaveragenumbercountintegerskillsstring[]taglinestringnullabletitlestringupdated_attimestampurlstringyears_coachingintegernullablepaginationPaginationhas_morebooleanlimitintegeroffsetinteger
Example response
{
"data": [
{
"id": "3f2b8c1e-5d4a-4b7c-9e2f-1a2b3c4d5e6f",
"name": "Anna Nováková",
"certified": false,
"city": "Prague",
"coaching_mode": "in_person",
"cover_url": null,
"description": "string",
"distance_meters": 0,
"experience_level": null,
"handle": "coach-anna",
"home_place": {
"id": "3f2b8c1e-5d4a-4b7c-9e2f-1a2b3c4d5e6f",
"name": "Letná Street Workout Park",
"location": {
"latitude": null,
"longitude": null
}
},
"photo_url": null,
"rating": {
"average": 4.6,
"count": 38
},
"skills": [
"string"
],
"tagline": null,
"title": "Calisthenics coach",
"updated_at": "2026-10-20T09:30:00Z",
"url": "https://www.caliplaces.com/trainer/coach-anna",
"years_coaching": 6
}
],
"pagination": {
"has_more": true,
"limit": 20,
"offset": 0
}
}Get a coach
Parameters
| Name | Type | Description |
|---|---|---|
idpathrequired | string | Coach id or handle |
Request
curl "https://api.caliplaces.com/open/v1/coaches/coach-anna" \
-H "Authorization: Bearer $CALIPLACES_API_KEY"Response 200 · Coach
iduuidnamestringcertifiedbooleancitystringnullablecoaching_modestringin_person = at their home place, online = remote coaching, hybrid = both. One of: "in_person", "online", "hybrid".
cover_urlstringnullabledescriptionstringdistance_metersnumbernullableexperience_levelstringnullablebeginner, intermediate, advanced or as set by the coach.
handlestringhome_placePlaceRefnullableThe park the coach trains clients at in person, if any.
iduuidnamestringlocationLocationnullablelatitudenumberlongitudenumberphoto_urlstringnullableratingRatingnullableaveragenumbercountintegerskillsstring[]taglinestringnullabletitlestringupdated_attimestampurlstringyears_coachingintegernullable
Example response
{
"id": "3f2b8c1e-5d4a-4b7c-9e2f-1a2b3c4d5e6f",
"name": "Anna Nováková",
"certified": false,
"city": "Prague",
"coaching_mode": "in_person",
"cover_url": null,
"description": "string",
"distance_meters": 0,
"experience_level": null,
"handle": "coach-anna",
"home_place": {
"id": "3f2b8c1e-5d4a-4b7c-9e2f-1a2b3c4d5e6f",
"name": "Letná Street Workout Park",
"location": {
"latitude": 50.0755,
"longitude": 14.4378
}
},
"photo_url": null,
"rating": {
"average": 4.6,
"count": 38
},
"skills": [
"string"
],
"tagline": null,
"title": "Calisthenics coach",
"updated_at": "2026-10-20T09:30:00Z",
"url": "https://www.caliplaces.com/trainer/coach-anna",
"years_coaching": 6
}