Developer API/API quickstart

API quickstart

Read event data from Strave with an organisation API key.

Use the Strave API to read your organisation's tournament data and react to live event changes. The API is read-only and every request is scoped to the organisation that created the API key.

Base URL

https://api.strave.gg/v1

1. Create an API key

Open your organisation, choose Settings → Developer API, and create a key. Copy the secret when it is shown and store it as STRAVE_API_KEY in your server's secret store. Never expose it in browser code or a public overlay.

2. Make your first request

curl https://api.strave.gg/v1/events \
  --header "Authorization: Bearer $STRAVE_API_KEY"

Successful collection responses use a consistent envelope:

{
	"data": [],
	"meta": {
		"count": 0
	}
}

Single-resource responses use { "data": { ... } }.

3. Read an event

Use an ID from the event collection to retrieve related resources:

curl https://api.strave.gg/v1/events/$EVENT_ID/matches \
  --header "Authorization: Bearer $STRAVE_API_KEY"

The same event ID can be used with stages, groups, rounds, participants, standings, invitations, broadcast data, and playdays.

4. React to changes

Connect to wss://api.strave.gg/v1/gateway, identify with the same key, and subscribe to the topics you need. When a dispatch arrives, fetch the referenced resource again to receive its current state.

The TypeScript SDK handles authentication, validation, heartbeat, reconnection, and sequence resume.

Next steps