Skip to content

Explore the API

Make your first API call in about two minutes. No app registration, no callbacks, no OAuth. You, an API key, and one request.

1. Sign up

Register at app.sweatstack.no/register. Free, no credit card.

2. Connect a wearable, so you have data to query

Link Garmin, Intervals.icu or Wahoo at Settings → Sharing. Activities start syncing immediately, and a typical user's full history is in within one or two minutes. Skip this step if you already have data in SweatStack.

3. Get an API key

Create one at Settings → API. Treat it like a password.

export SWEATSTACK_API_KEY="sk_..."

4. Make your first call

curl https://app.sweatstack.no/api/v1/activities/latest \
  -H "Authorization: Bearer $SWEATSTACK_API_KEY"

The API returns a JSON object describing your most recent activity:

{
  "id": "01HF...",
  "sport": "cycling",
  "start": "2026-05-17T06:14:22Z",
  "summary": {
    "duration": 5421,
    "distance": 42137.4,
    "...": "..."
  }
}

Install the SDK:

uv add sweatstack

Save this as app.py:

from sweatstack import Client

client = Client()

activity = client.activities.latest()
print(activity)

Run it:

uv run python app.py

It prints your most recent activity as a Python object. The SDK reads the API key from SWEATSTACK_API_KEY.

That's it. You're on the API.

What's next

  • Browse every endpoint. The API reference lists every route with its parameters and response schema. To run requests live against your account in the browser, use the API playground.
  • Compute something with the data. See Activities, Dailies, Tests, and Metabolic profile. The Python SDK works in any notebook: install sweatstack[polars] or sweatstack[pandas], and call authenticate() in the first cell.
  • Let other people sign in to your app. Move on to Build an app for the full OAuth flow with FastAPI, Streamlit, or any HTTP client.