komoot API documentation version v007
https://external-api.komoot.de/v007/
General
This API is only available to partners, who signed a corresponding partner contract. It is prohibited to use the API without such a contract.
Authentication
Clients need a valid oauth2 authentication to retrieve data from the api. You have to establish an oauth2 connect to retrieve the necessary access token
. Once you have it, add a header to your request:
Authorization: Bearer <oauth2 access token>
OAuth Scopes
The API uses different scopes to verify access to resources. The required scopes for you application need to be requested in the authorization process via the scope
field. Currently these scopes exist:
profile
- is required to fetch the user's tour list as well as the details to individual tourstour-upload
- is required to upload new tours to the user's account
General information
- The API returns HAL/json
- The server may add new properties to json documents. Clients must ignore unknown properties (backwards compatible)
- Json properties that hold enumerations or types (e.g. sport types or direction types) can be extended in future. Clients must handle unknown types and provide suitable defaults (backwards compatible).
- The headers
Cache-control
,Last-modified
and etags are set if applicable. - If resources contain i18n content, the
Accept-Language
header is used to return the most suitable content. - For further help you can contact partner@komoot.de
User
Retrieve a list of tours the user has created, recorded or participated on. Items are sorted by tour date, descending. If the list is long, it may be paginated. In this case, next
and prev
HAL links provide URLs for the next and previous pages.
Tour
Uploads a tour via uploading a FIT or GPX file. The file's byte data is sent as POST body.
This resource needs authentication
Retrieve a tour as a GPX file. A tour may be a planned tour or a recorded tour.