API access to Intervals.icu

Guide
530

I’ve been experimenting with the API using the RapiDoc UI, looking at power curves, it seems like the activity type is not being filtered correctly.

For the request:

curl -X GET "https://intervals.icu/api/v1/athlete/0/power-curves{ext}?curves=84d&type=Ride"

Run activities are being returned in the activity list at the bottom of the response. To confirm this I tried the following:

curl -X GET "https://intervals.icu/api/v1/athlete/0/power-curves{ext}?curves=7d&type=Ride"

In the past 7 days I have only run, this should return an empty list, but instead it returns my power curve based on the runs I’ve done the past 7 days.

Have I found a bug, or am I doing something wrong?

Thanks,
Andrew

531

Ooops I broke that when I added the “zero athlete id” stuff. Fixed now. Tx for the report.

532

@david Is it possible to get fitness and fatigue broken down by activity type via the API? I do triathlon and would like data for the three disciplines separately.

534

No. Intervals.icu only stores the “all sports” versions of those. You would need to compute it yourself from the load on each activity.

535

How to create an event in athlete calendar and upload attachments in one single request?

536

There isn’t an endpoint to create attachments yet. I need to think about how to do that. Probably not as a single call though because the endpoint will accept multipart form data for the attachment file and that doesn’t play nicely with a JSON event payload.

538

When uploading activity files (POST /api/v1/athlete/{id}/activities), is there a way to signal that the external_id belongs to a specific platform? Specifically, I’m uploading old Zwift rides and I have the Zwift ID, so it’d be neat if I could properly link it.

Edit: Or afterwards with an update.

539

Unfortunately not really. Activities do have a source (e.g. ZWIFT) which is what triggers the link creation in the client app but making that updatable would cause problems with some sources.

1 Like
541

Sorry for responding to an old post. I just discovered Streamlit it looks interesting. Are there any apps published that would interact with Intervals.icu or related to Running in general? I’m thinking for example taking some specific workouts performed as Test and then predicting various metrics and training zones depending on some models.

543

I fixed the CORS problem, I’d initially spelled “Authorization” using British English with an “s”, and then browser caching meant that the bad request kept being submitted. For the benefit of any future readers here is working code to fetch data from the intervals.icu API using browser based JavaScript.

async function fetchData() {
    const base64UsernamePassword = btoa("API_KEY:YOURKEY");
    const url = "https://intervals.icu/api/v1/athlete/0/wellness/2025-01-29";
    try {
        const response = await fetch(url, {
            method: "GET",
            headers: {
                "Authorization": "Basic " + base64UsernamePassword,
            },
        });
        if (!response.ok) {
            throw new Error(`HTTP error! Status: ${response.status}`);
        }
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error("Error fetching data:", error);
    }
}

Hope that’s helpful to someone else!

3 Likes
544

Can’t we have the Authorisation spelt the proper way?

3 Likes
545

Nice one! I tried all morning to connect but to no avail until I stumbled on this post:)

1 Like
546

Hi, I’m begginer in this things but I’m trying get data from my specific workout and I’m getting this error:
{“status”:500,“error”:“org.springframework.web.method.annotation.MethodArgumentTypeMismatchException: Failed to convert value of type ‘java.lang.String’ to required type ‘int’; nested exception is java.lang.NumberFormatException: For input string: "13632114836"”}%

This is what I type in terminal:
curl -X GET “https://intervals.icu/api/v1/athlete/i235611/workouts/13632114836”
-H ‘accept: /’ -u “API_KEY:xxxxx”

Do you have some ideas?

547

I beleive you’re usigthe wrong endpoint

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

/api/v1/activity/{id} <<< should be this one i believe

or are you trying to get the FIT file?
also take a look here

1 Like
548

Hello, I’m new to using APIs to access data and would like to be able to automate bringing the Gear table into Google Sheets. I tried =IMPORTDATA(“https://intervals.icu/api/athlete//gear.csv”,“,”) but that didn’t work. I know I will need to pass the API key, but I don’t know if there is a way to do it in the URL. I’m open to other ways of doing it. Can anyone help?

Thanks!

549

IMPORTDATA will not work that simple way you think.

You need an google AppsScript doing the job for you. Downloading the CSV, parsing to tabular format, pushing finally to the table,… as far as I can remember @William_Barnes shared an link with an example you can adjust.

550

Are the weekly load / duration / distance targets per sport exposed through API at all?

551

I think so, I am pretty sure as I am getting it. See Note 2 in thread below

tho i forgot where I found it

552

Yes they are through the list calendar events endpoint: GET /api/v1/athlete/{id}/events

You can specify category=TARGET to get only the targets.

553

Is this api function still valid? I trying to write a script to update my FTP in intervals with my TP from Xert, but I’m getting a 403 error back. I’ve double checked by atheleid and api key and both are correct.