WHOOP

WHOOP API

The WHOOP API exposes member fitness, strain, recovery, sleep, workout, and body measurement data captured by the WHOOP wrist-worn wearable. v2 endpoints return UUID-based resources covering physiological cycles, sleep activities, workouts, recovery scores, and user profile data, with webhook notifications for `recovery.updated`, `recovery.deleted`, `sleep.updated`, `sleep.deleted`, `workout.updated`, and `workout.deleted` events. OAuth 2.0 authorization-code flow protects member data; a separate client-credentials flow (Trusted Partner) supports lab-grade health partners. Rate limits default to 100 requests/minute and 10,000 requests/day per client.

Documentation GitHub OpenAPI

Documentation

https://developer.whoop.com/api/

https://developer.whoop.com/docs/introduction/

https://developer.whoop.com/docs/developing/oauth/

https://developer.whoop.com/docs/developing/rate-limiting/

Specifications

https://api.prod.whoop.com/developer/doc/openapi.json

https://raw.githubusercontent.com/api-evangelist/whoop-co/refs/heads/main/openapi/whoop-api-openapi.yml

Examples

https://raw.githubusercontent.com/api-evangelist/whoop-co/refs/heads/main/examples/whoop-list-workouts-example.json

https://raw.githubusercontent.com/api-evangelist/whoop-co/refs/heads/main/examples/whoop-get-recovery-example.json

https://raw.githubusercontent.com/api-evangelist/whoop-co/refs/heads/main/examples/whoop-list-sleep-example.json

https://raw.githubusercontent.com/api-evangelist/whoop-co/refs/heads/main/examples/whoop-webhook-sleep-updated-example.json

Schemas & Data

https://raw.githubusercontent.com/api-evangelist/whoop-co/refs/heads/main/json-schema/whoop-cycle-schema.json

https://raw.githubusercontent.com/api-evangelist/whoop-co/refs/heads/main/json-schema/whoop-recovery-schema.json

https://raw.githubusercontent.com/api-evangelist/whoop-co/refs/heads/main/json-schema/whoop-sleep-schema.json

https://raw.githubusercontent.com/api-evangelist/whoop-co/refs/heads/main/json-schema/whoop-workout-schema.json

Other Resources

https://raw.githubusercontent.com/api-evangelist/whoop-co/refs/heads/main/json-ld/whoop-co-context.jsonld

SpectralRuleset

https://raw.githubusercontent.com/api-evangelist/whoop-co/refs/heads/main/rules/whoop-rules.yml

https://developer.whoop.com/docs/developing/webhooks/

OpenAPI Specification