Caliplaces
Open API · v1.0 · Beta

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

  1. Sign in with your Caliplaces account and create a project.
  2. Create an API key in the project. Copy it now: it is shown only once.
  3. 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:

ScopeAllows
places:readGET /places, /places/{id}, /cities
events:readGET /events, /events/{id}
coaches:readGET /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:

HeaderMeaning
X-RateLimit-LimitRequests allowed per minute
X-RateLimit-RemainingRequests left in the current minute
X-Quota-LimitFree plan: requests allowed per calendar month (UTC)
X-Quota-RemainingFree plan: requests left this month
X-Quota-ResetFree plan: when the monthly allowance starts over (RFC 3339)
X-Credits-RemainingPay as you go: credits left after this call, e.g. 24.998000
Retry-AfterOn 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:

429 Too Many Requests
{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Retry after the time in the Retry-After header."
  }
}
StatusCodeMeaning
400invalid_parameterA query parameter is missing its pair, out of range or malformed. The message names it.
401missing_api_keyNo Authorization: Bearer header.
401invalid_api_keyThe key does not exist or is mistyped.
401revoked_api_keyThe key was revoked in the dashboard.
401expired_api_keyThe key passed its expiry date.
402insufficient_creditsPay as you go: the credit balance is too low for this call. Top up in the dashboard.
402spend_cap_reachedPay as you go: your monthly spending cap is reached. Raise it or wait for the 1st (UTC).
403insufficient_scopeThe key lacks the scope this endpoint needs.
403project_suspendedThe project was suspended. Write to us.
403account_suspendedThe Caliplaces account that owns the project is not active.
404not_foundNo such item, or it is not public.
405method_not_allowedThe API is read-only: use GET.
429rate_limitedOver the per-minute limit. Wait for Retry-After seconds.
429monthly_quota_exceededThe month’s requests are used up. Resets on the 1st (UTC).
429too_many_failed_attemptsToo many requests with bad keys from your address.
500internal_errorOur fault. Not counted against your limits.
503service_unavailableBriefly 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

GET/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

NameTypeDescription
qstringSearch names and addresses (2-100 characters)
latnumberLatitude of the centre point (needs lng)
lngnumberLongitude of the centre point (needs lat)
radius_kmnumberSearch radius around lat/lng in km, up to 100. Default: 10.
bboxstringBounding box min_lng,min_lat,max_lng,max_lat, at most 5 degrees each way
citystringExact city name, case-insensitive
countrystringExact country name, case-insensitive
typestringpark or gym
min_ratingnumberOnly places rated at least this (1-5)
updated_sincestringOnly places changed since this RFC 3339 time, for syncing
limitintegerPage size, 1-50. Default: 20.
offsetintegerItems 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[]
  • iduuid
  • namestring
  • addressstring
  • amenitiesstring[]
  • citystringnullable
  • conditionstring

    ok, or a reported problem with the place. One of: "ok", "under_construction", "temporarily_closed", "permanently_closed", "damaged".

  • countrystringnullable

    Country as stored by the place's author, usually the English name.

  • created_attimestamp
  • descriptionstringnullable
  • distance_metersnumbernullable

    Only set when the request was filtered by lat/lng.

  • locationLocation
  • latitudenumber
  • longitudenumber
  • opening_hoursstringnullable
  • photosstring[]

    Full-size photo URLs, watermarked.

  • ratingRatingnullable
  • averagenumber
  • countinteger
  • tagsstring[]
  • thumbnail_urlstringnullable
  • typestring

    One of: "park", "gym".

  • updated_attimestamp
  • urlstring

    The place's page on caliplaces.com. Link to it when you show the data.

  • websitestringnullable
  • paginationPagination
  • has_moreboolean
  • limitinteger
  • offsetinteger
Example response
200 OK
{
  "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

GET/places/{id}

Parameters

NameTypeDescription
idpathrequiredstringPlace id

Request

curl "https://api.caliplaces.com/open/v1/places/7c9e6679-7425-40de-944b-e07fc1f90ae7" \
  -H "Authorization: Bearer $CALIPLACES_API_KEY"

Response 200 · Place

  • iduuid
  • namestring
  • addressstring
  • amenitiesstring[]
  • citystringnullable
  • conditionstring

    ok, or a reported problem with the place. One of: "ok", "under_construction", "temporarily_closed", "permanently_closed", "damaged".

  • countrystringnullable

    Country as stored by the place's author, usually the English name.

  • created_attimestamp
  • descriptionstringnullable
  • distance_metersnumbernullable

    Only set when the request was filtered by lat/lng.

  • locationLocation
  • latitudenumber
  • longitudenumber
  • opening_hoursstringnullable
  • photosstring[]

    Full-size photo URLs, watermarked.

  • ratingRatingnullable
  • averagenumber
  • countinteger
  • tagsstring[]
  • thumbnail_urlstringnullable
  • typestring

    One of: "park", "gym".

  • updated_attimestamp
  • urlstring

    The place's page on caliplaces.com. Link to it when you show the data.

  • websitestringnullable
Example response
200 OK
{
  "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

GET/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

NameTypeDescription
countrystringExact country name, case-insensitive
limitintegerPage size, 1-50. Default: 20.
offsetintegerItems 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[]
  • citystring
  • countrystring
  • locationLocation

    Centre of the city's places, handy for a map or a nearby search.

  • latitudenumber
  • longitudenumber
  • place_countinteger
  • paginationPagination
  • has_moreboolean
  • limitinteger
  • offsetinteger
Example response
200 OK
{
  "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

GET/events

Public competitions and meetups, soonest first. By default only events that have not ended yet; pass from to look further back.

Parameters

NameTypeDescription
kindstringcompetition or meetup
place_idstringOnly events at this place
fromstringOnly events still running at or after this RFC 3339 time. Defaults to now.
tostringOnly events starting at or before this RFC 3339 time
latnumberLatitude of the centre point (needs lng)
lngnumberLongitude of the centre point (needs lat)
radius_kmnumberSearch radius around lat/lng in km, up to 100. Default: 10.
limitintegerPage size, 1-50. Default: 20.
offsetintegerItems 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[]
  • iduuid
  • namestring
  • categoriesEventCategory[]
  • namestring
  • capacityintegernullable
  • descriptionstringnullable
  • priceMoneynullable

    Entry fee. Null when entry is free or the price is not set.

  • amount_minorinteger
  • currencystring
  • cover_urlstringnullable
  • descriptionstringnullable
  • distance_metersnumbernullable
  • ends_attimestampnullable
  • kindstring

    One of: "competition", "meetup".

  • organizerOrganizernullable
  • namestring
  • handlestringnullable
  • logo_urlstringnullable
  • starts_attimestampnullable
  • statusstring

    finalized = results are final. One of: "published", "finalized".

  • taglinestringnullable
  • timezonestring

    IANA time zone the event is held in, for displaying local times.

  • updated_attimestamp
  • urlstring
  • venueVenue
  • namestringnullable
  • addressstringnullable
  • locationLocationnullable
  • latitudenumber
  • longitudenumber
  • place_iduuidnullable
  • paginationPagination
  • has_moreboolean
  • limitinteger
  • offsetinteger
Example response
200 OK
{
  "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

GET/events/{id}

Parameters

NameTypeDescription
idpathrequiredstringEvent id

Request

curl "https://api.caliplaces.com/open/v1/events/2f1c9a8e-7b6d-4c3e-9f0a-1b2c3d4e5f60" \
  -H "Authorization: Bearer $CALIPLACES_API_KEY"

Response 200 · Event

  • iduuid
  • namestring
  • categoriesEventCategory[]
  • namestring
  • capacityintegernullable
  • descriptionstringnullable
  • priceMoneynullable

    Entry fee. Null when entry is free or the price is not set.

  • amount_minorinteger
  • currencystring
  • cover_urlstringnullable
  • descriptionstringnullable
  • distance_metersnumbernullable
  • ends_attimestampnullable
  • kindstring

    One of: "competition", "meetup".

  • organizerOrganizernullable
  • namestring
  • handlestringnullable
  • logo_urlstringnullable
  • starts_attimestampnullable
  • statusstring

    finalized = results are final. One of: "published", "finalized".

  • taglinestringnullable
  • timezonestring

    IANA time zone the event is held in, for displaying local times.

  • updated_attimestamp
  • urlstring
  • venueVenue
  • namestringnullable
  • addressstringnullable
  • locationLocationnullable
  • latitudenumber
  • longitudenumber
  • place_iduuidnullable
Example response
200 OK
{
  "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

GET/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

NameTypeDescription
qstringSearch names, titles and handles (2-100 characters)
latnumberLatitude of the centre point (needs lng)
lngnumberLongitude of the centre point (needs lat)
radius_kmnumberSearch radius around lat/lng in km, up to 100. Default: 10.
place_idstringOnly coaches whose home place is this one
onlinebooleantrue = only coaches offering online coaching
limitintegerPage size, 1-50. Default: 20.
offsetintegerItems 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[]
  • iduuid
  • namestring
  • certifiedboolean
  • citystringnullable
  • coaching_modestring

    in_person = at their home place, online = remote coaching, hybrid = both. One of: "in_person", "online", "hybrid".

  • cover_urlstringnullable
  • descriptionstring
  • distance_metersnumbernullable
  • experience_levelstringnullable

    beginner, intermediate, advanced or as set by the coach.

  • handlestring
  • home_placePlaceRefnullable

    The park the coach trains clients at in person, if any.

  • iduuid
  • namestring
  • locationLocationnullable
  • latitudenumber
  • longitudenumber
  • photo_urlstringnullable
  • ratingRatingnullable
  • averagenumber
  • countinteger
  • skillsstring[]
  • taglinestringnullable
  • titlestring
  • updated_attimestamp
  • urlstring
  • years_coachingintegernullable
  • paginationPagination
  • has_moreboolean
  • limitinteger
  • offsetinteger
Example response
200 OK
{
  "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

GET/coaches/{id}

Parameters

NameTypeDescription
idpathrequiredstringCoach id or handle

Request

curl "https://api.caliplaces.com/open/v1/coaches/coach-anna" \
  -H "Authorization: Bearer $CALIPLACES_API_KEY"

Response 200 · Coach

  • iduuid
  • namestring
  • certifiedboolean
  • citystringnullable
  • coaching_modestring

    in_person = at their home place, online = remote coaching, hybrid = both. One of: "in_person", "online", "hybrid".

  • cover_urlstringnullable
  • descriptionstring
  • distance_metersnumbernullable
  • experience_levelstringnullable

    beginner, intermediate, advanced or as set by the coach.

  • handlestring
  • home_placePlaceRefnullable

    The park the coach trains clients at in person, if any.

  • iduuid
  • namestring
  • locationLocationnullable
  • latitudenumber
  • longitudenumber
  • photo_urlstringnullable
  • ratingRatingnullable
  • averagenumber
  • countinteger
  • skillsstring[]
  • taglinestringnullable
  • titlestring
  • updated_attimestamp
  • urlstring
  • years_coachingintegernullable
Example response
200 OK
{
  "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
}