API access to Intervals.icu

[Harrison]

I have tried a few different set ups and received this error.

Error 404 while accessing /athlete-profile
Response: {“timestamp”:“2025-05-26T14:42:42.070+00:00”,“status”:404,“error”:“Not Found”,“path”:“/api/v1/athlete-profile”}
Could not retrieve athlete profile.

[Harrison]

Ran another script and received this error.

Error 403 while accessing /athlete/i87631
Response: {“status”:403,“error”:“Access denied”}
Could not retrieve athlete profile.

[MedTechCD]

You almost certainly made the ‘usual’ error…
To acces the API, the username is the literal string ‘API_KEY’ (AND THUS NOT your api or athlete id) and the password is your personal Api-key.
If not, post some examples of your curl commands.
Should look like
curl.exe -u API_KEY:8765abcd3432s2u3h3tyhmnof https://intervals.icu/api/v1/athlete/i6789/wellness.csv?

[R2Tom]

The user name is ’API_KEY’ with basic auth.

[Harrison]

Still getting the 404 error.

curl -u API_KEY:xxx https://intervals.icu/api/v1/athlete/i87631/fitness

[Andreas_Schnederle-W]

@Harrison

https://intervals.icu/api/v1/athlete/i87631/fitness

this one doesn’t exist - have a look for available Endpoints here: Swagger UI - you can also Try them out directly …

[Harrison]

Yes, received the 403 access denied.

[Andreas_Schnederle-W]

are you sure your API Key and Athlete ID match?

[Harrison]

Yes, coping them.

[Andreas_Schnederle-W]

You already tried with the Swagger Tool?

https://intervals.icu/api/v1/docs/swagger-ui/index.html

and then try one of the Endpoints

[david]

@Harrison

Still getting the 404 error.

curl -u API_KEY:xxx https://intervals.icu/api/v1/athlete/i87631/fitness

I don’t think that endpoint exists. If you are looking for “fitness over time” call this endpoint.

[Xavi_Roig_Aznar]

I am trying to get my training plan using the Swagger Tool and I am receiving a 403 too. The cURL is the following one:

curl -X 'GET' \
  'https://intervals.icu/api/v1/athlete/i349268/training-plan' \
  -H 'accept: */*' \
  -H 'Authorization: Basic {Base64 encrypted API_KEY:myApiKey}'

And the response that I am obtaining is:

{
  "status": 403,
  "error": "Access denied"
}

PS: I have also done the Authorize step before trying this endpoint.

[MedTechCD]

Works fine for me with the Swagger tool as per the instructions @Andreas_Schnederle-W posted above.

PS: I don’t have a plan and the response indicates ‘null’ without errors.

[Xavi_Roig_Aznar]

I have to grant any developer permissions in Intervals ICU to be able to access the API or I just only have to get the API Key from the settings page?

[app4g]

@Xavi_Roig_Aznar

I just only have to get the API Key from the settings page?

For own usage, this is fine and recommended.

[Guillaume_Forstmann]

Hi,

I’m building an AI Agent that can create structured workouts for me and push them to Intervals.icu. Ideally, the agent will also be able to retrieve completed workout data afterward in order to analyze the session and provide personalized feedback.

Right now, I’m using my own personal Intervals.icu account to test this out, so I’m not implementing full OAuth just yet — just using my API key for now.

I have two questions:

1. What’s the proper flow to post a structured workout to my calendar?
   For example, is it:

• Step 1: Create a workout folder
• Step 2: Upload a structured workout to that folder
• Step 3: Schedule it on the calendar using the workout ID?

2. What’s the recommended way to retrieve completed workout data ?
   Should I query the calendar? Or is there a better endpoint for retrieving performance data after a session?

I’m not a developer by trade, so feel free to explain it like I’m five

Thank you !

Guillaume

[david]

You can just upload workouts directly to your calendar, no need to put them in a folder first. There is some info here:

Uploading planned workouts to Intervals.icu

This guide explains how to upload calendar events (e.g. workouts) from an external application to an athlete’s Intervals.icu calendar using the API. For more information about the API including OAuth support please see this post. You need to request CALENDAR:WRITE scope to make changes to an athlete’s calendar. All the calendar related endpoints are documented here. Intervals.icu calendar events have an id (primary key) and optional external_id (your primary key). You do not need to use extern…

[david]

@Guillaume_Forstmann

What’s the recommended way to retrieve completed workout data ?
Should I query the calendar? Or is there a better endpoint for retrieving performance data after a session?

See “Downloading completed activities” in this post:

Intervals.icu API Integration Cookbook

This tells you everything you need to know to get completed activities into Intervals.icu, to download planned workouts and to read and update wellness data. Example calls use curl so you can easily try them out. Sources: API access to Intervals.icu Intervals.icu OAuth support Intervals.icu API docs Authorization Apps need to use an access_token obtained via OAuth. If you are just working with your own data call the API using your personal API key (available towards the bottom of the setting…

[nasatt]

I’m trying to test the API from a python script, with the eventual goal of automating workout uploads

---

import requests

API_KEY = “correctapihere”
ATHLETE_ID = “correctathleteidhere”
URL = f"https://intervals.icu/api/v1/athlete/{ATHLETE_ID}"

headers = {“Authorization”: f"Bearer {API_KEY}"}
response = requests.get(URL, headers=headers)

print(response.status_code)
print(response.text)

---

That’s the code I’m using. I am getting a {“status”:403,“error”:“Access denied”} error
Any ideas why? API key and athlete id are 100% entered correctly

Thanks

[MedTechCD]

API access to Intervals.icu

You need to use basic with with your API key, not Bearer … thats only for oauth.

Don’t use Bearer, use Basic authentication