Explore the API¶
Make your first API call in about two minutes. No app registration, no callbacks, no OAuth. Just you, an API key, and a curl.
1. Sign up¶
app.sweatstack.no/register. Free, no credit card.
2. Connect a wearable so you have data to query¶
Link Garmin or Intervals.icu at Settings → Sharing. Activities start syncing immediately. A typical user's full history lands within a minute or two. Skip this step if you already have data in SweatStack.
3. Grab an API key¶
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"
You get back a JSON object describing your most recent activity:
{
"id": "01HF...",
"sport": "cycling",
"start": "2026-05-17T08:14:22+02:00",
"summary": {
"duration": 5421,
"distance": 42137.4,
"...": "..."
}
}
uv add sweatstack
import sweatstack
activity = sweatstack.get_latest_activity()
print(activity)
Run it:
uv run python app.py
You see your most recent activity printed as a Python object.
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 pairs well with notebooks via the Jupyter helper.
- 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.