Intervals.icu API Integration Cookbook

[Edoardo_Gallo]

Got it - thanks for the details!

[Johnnyharries]

Hi David,

I’ve been experimenting with the Intervals.icu API and running into some persistent issues I wondered if you might be able to help with.

I’ve been attempting to retrieve activity data using my API key, but consistently getting 403 errors, both via Apple Shortcuts and directly with cURL from my desktop. I’ve double-checked the endpoints, headers, and bearer token formatting, and even tried using the API tester’s generated cURL commands — all returning the same 403.

I also wasn’t sure if privacy settings might be interfering, though my understanding is that the API key should authenticate me as the account holder regardless.

Additionally, I noticed that activity IDs in the API docs are listed as int32, while athlete IDs are strings — which seemed consistent with what I was working with, but wanted to confirm there’s no mismatch expected there.

Would you mind taking a look or pointing me in the right direction? I suspect I’m either missing something obvious or possibly bumping into a permission issue on my account.

Thanks a lot for your time — I appreciate it.

[R2Tom]

@Johnnyharries

bearer token formatting

You have to use basic auth, not bearer.

[MedTechCD]

The API uses basic authentication for personal use. The username is “API_KEY” and the password your API key. Example using curl:

$ curl -u API_KEY:1l0nlqjq3j1obdhg08rz5rfhx https://intervals.icu/api/v1/athlete/2049151/activities.csv

API access to Intervals.icu

Intervals.icu now has a public API for other applications. To use it you need to generate an API key in /settings (look for “Developer Settings” near the bottom). Your API key allows other applications to access your Intervals.icu data. Be careful what you do with it! If you suspect that your key may have been compromised immediately clear or re-generate it. The API uses basic authentication for personal use. The username is “API_KEY” and the password your API key. Example using curl: $ curl -…

[Johnnyharries]

That’s exactly the thing I needed to crack it thank you!

So now I’m making good progress pulling down my activities.csv list via the /athlete/{id}/activities.csv endpoint — works great.

I noticed there’s a /activities/{id}/laps.csv endpoint for rides, and was wondering: is there anything equivalent for runs? Or any way to download the full activity data or laps via the API for run activities, similar to what you can export manually from the web UI?

Apologies if I’ve missed something obvious — just getting my head around what’s possible via the API at the moment.

Thanks so much for the great platform and API access — it’s been brilliant so far. And a super responsive community too.

[Sensitron]

Hi David,

another question from my side.
Is there a possibility to check when an activity has been updated?

For example, “wellness” has an “updated: date-time” which sets a timestamp when the wellness data has been updated (e.g. steps increased from garmin).

But for activity i can’t see something similiar. There is a “icu_sync_date: date-time” but when i change my activity in garmin connect (e.g. adding a comment), the activity in intervals.icu is updated. But the “icu_sync_date” is still the same.

Is this on purpose and i need to use Webhooks (i currently have no registered app at intervals, since im just doing a little private coding project where i want to sync my activities to my own database. I just check a few times a day if there has been added activities, but i’m missing when an activity has been updated)?

[david]

Unfortunately I forgot to include a general updated data originally. I will likely add it at some point.

[Aindriu]

Hi. I’m trying to update Power Zones via the API. Is there any guidance on the format for the power_zones input - the Cookbook just say its Interger values as part of an array. Does this need to contain the lower and upper limits of each zone e.g. [0,150,151,220,221,260,261,300,301,340,341,430,431], or should it just include the values of the lower bouund? [0,151,221,261,301,341,431].

I only really want update the boundary between z2 and z3, but I’m assumning I need to include all the zones in the array?

thanks

[app4g]

the endpoint reports values in this format.

“power_zones”:[55,75,90,105,120,150,999]

so looks like it’s the upper

[Aindriu]

Thanks! I seem to now be getting a 422 error when including the power_zones array in the exisiting API call I have working. The body is below. Any idea what might be causing the error? Auth is fine as it works without the power_zones element.

{"ftp":288,"indoor_ftp":288,"power_zones":[55,78,90,105,120,150,999]}

Thanks in advance

[david]

That endpoint was a bit buggy in that you had to update the power zones, names, sweet spot etc. all together. I have fixed that. You can now update just the zones or just the names etc… I still need to make similar changes to updating HR and pace zones.