API access to Intervals.icu

Guide
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.

554

Error 403 means access denied. Do you have the user API_KEY and as password you actual api key? Do you use basic auth not bearer?

2 Likes
556

I just did this with my API key and it worked:

curl -XPUT -u API_KEY:xxx 'https://intervals.icu/api/v1/athlete/0/sport-settings/Ride' \
    -d '{ "ftp": 300 }' -H "Content-Type: application/json"

You can usually use 0 instead of the athlete ID like I did here.

557

Hi,
I would like to ask to add an REST API endpoint to find activities in selected bounding box?
Smth like: /athlete/{id}/activities?bounds=-54,10.11,-50.95,11.10 and it will return activites (just id will be enough actually) within this box.

558

Unfortunately I can’t do that at the moment. I neglected to store the start or end point on activity and the GPS data is in offline storage and not searchable. I am going to add the start and end point to the activity but it will take a very long time to get that updated from the GPS data.

559

Is it possible to add pagination for GET /api/v1/athlete/{id}/activities with page size and offset? Current limit works, but doesn’t give any information how much more data you have.

560

I left that out because it is much more efficient to query that data using the oldest and newest parameters. So rather page by month or 3 months.

I figured out that I can do this for activities with routes. Will try get it done soon.

1 Like
561

I am trying to send feedback comments to an Intervals.icu activity but they are not reaching the platform. I share my implementation and would appreciate any hints.

  1. Endpoint and authentication
    Method: POST
    URL:
    https://intervals.icu/api/v1/activity/{activity_id}/messages
    Headers:
    http
    Authorisation: Basic <base64(‘API_KEY:{tu_api_key}’)>
    Content type: application/json
    Payload (JSON):

{ ‘message’: ‘Your feedback comment here’ }
2) Python integration class

import base64
import requests

IntervalsAPI class:
def init(self, athlete_id, api_key):
self.base_url = ‘https://intervals.icu’
auth_str = f ‘API_KEY:{api_key}’
self.headers = {
‘Authorization": f “Basic {base64.b64encode(auth_str.encode()).decode()}”,
‘Content-Type": ’application/json’
}

def post_activity_comment(self, activity_id, comment):
    url = f"{self.base_url}/api/v1/activity/{activity_id}/messages’
    payload = {‘message’: comment}
    resp = requests.post(url, headers=self.headers, json=payload)
    print(resp.status_code, resp.text) # To debug
    resp.raise_for_status()
    return resp.json()
  1. Call from Streamlit

if st.button(‘Post feedback’):
response = intervals_api.post_activity_feedback(
activity_details[‘id’],
st.session_state.athlete_feedback
)
if isinstance(response, dict) and ‘error’ in response:
st.error(f ‘Error posting: {response[’error‘]}’)
else:
st.success("Comment posted successfully.

562

You need to use ‘content’ in the payload and not ‘message’. Here is a example with curl:

curl -XPOST -u API_KEY:xxx 'https://intervals.icu/api/v1/activity/i75453212/messages' \
    -d '{ "content": "Hello!" }' -H "Content-Type: application/json"
1 Like
563

Thx David

565

Hi David,

I’m using the Intervals.icu API and can successfully pull activities data using Basic Auth with “API_KEY” as the username and my API key as the password.

However, when I try to access either the /daily endpoint or any wellness data endpoints, I consistently receive a 403 Forbidden error:

{“status”:403,“error”:“Access denied”}

I have wellness data visible in my account (HRV, sleep, weight, etc.) and I’ve already tried:

Deleting and regenerating my API key.

Verifying my API key works for the activities endpoint.

Using the correct Basic Auth format (auth = (“API_KEY”, api_key)).

Could you please confirm whether wellness data API access is enabled for my account or if any further permission changes are needed?

Many thanks!

566

Can you please post an example of a failing call with curl. You should be able to call any of the endpoints with your API key.

567

curl -u “API_KEY:7jf8y88m98x9ratfjlwrtlzzk” \

“https://intervals.icu/api/v1/athlete/i214614/wellness”

{“status”:403,“error”:“Access denied”}%

568

I think you either need to specify a date or date range or a an output format JSON/CSV/… to get the full history.

This post has working code (I think…)

569

Ah perfect thanks so much. I searched all the forums but just couldn’t fix it. This worked perfectly. Appreciate it.

570

Hi David — I’m an individual athlete and would like API access to integrate my training data into a personal coaching script using GPT. I’m not a coach, just building tools for personal use. Could you enable API access for my account?

571

It’s enabled and available for everyone.
You can find your athlete ID and API Key on the bottom of the Settings page under Developer Settings.