WHOOP website screenshot

WHOOP

WHOOP is a fitness and recovery wearable platform providing a REST API for accessing sleep, recovery, strain, and workout metrics from the WHOOP band. The API uses OAuth 2.0 authorization code flow with Bearer tokens to allow developers to build applications that access member health and performance data including physiological cycles, sleep stages, recovery scores, strain, heart rate, body measurements, and workout records.

WHOOP publishes 7 APIs on the APIs.io network, including Activity ID Mapping API, Cycle API, Partner API, and 4 more. Tagged areas include Fitness, Wearables, Health, Recovery, and Sleep.

The WHOOP catalog on APIs.io includes 1 JSON-LD context and 1 Spectral governance ruleset.

WHOOP’s developer surface includes authentication, documentation, engineering blog, pricing, and 11 more developer resources.

🌐 Visit website 📡 Source on GitHub
47.6/100 developing ▼ -5.2 Agent 34/100 agent aware Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreeSelf serve⚡ Free to try
7 APIs
FitnessWearablesHealthRecoverySleepWorkoutStrainHeart RatePerformance

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 47.6/100 · developing
Contract Quality 16.4 / 25
Developer Ergonomics 4.3 / 20
Commercial Clarity 7.9 / 20
Operational Transparency 5.5 / 13
Governance 7.0 / 12
Discoverability 7.4 / 10
Agent readiness — 34/100 · agent aware
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/whoop: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 7

Individual APIs this provider publishes, each with its own machine-readable definition.

WHOOP Activity ID Mapping API

Utility endpoints for activity ID mapping

WHOOP Cycle API

The Cycle API from WHOOP — 3 operation(s) for cycle.

WHOOP Partner API

Endpoints for trusted WHOOP partner operations

WHOOP Recovery API

The Recovery API from WHOOP — 2 operation(s) for recovery.

WHOOP Sleep API

The Sleep API from WHOOP — 3 operation(s) for sleep.

WHOOP User API

Endpoints for retrieving user profile and measurement data.

WHOOP Workout API

The Workout API from WHOOP — 2 operation(s) for workout.

Scroll for all 7

GraphQL 1

GraphQL schemas published by this provider.

WHOOP GraphQL API

WHOOP is a fitness wearable tracking recovery, strain, and sleep. The API covers physiological metrics (HRV, resting heart rate, SpO2), recovery scores, sleep stages, workout st...

GRAPHQL

Pricing Plans 1

Published pricing tiers and plan structures.

Whoop Plans Pricing

1 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Whoop Rate Limits

2 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Whoop Finops

FINOPS

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Whoop Context

2 classes · 16 properties

JSON-LD

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

WHOOP API Rules

5 rules · 4 warnings 1 info

SPECTRAL

JSON Schema 33

Standalone JSON Schema definitions for this provider's data models.

ActivityIdMappingResponse

1 properties

JSON SCHEMA

Appointment

2 properties

JSON SCHEMA

CreateObservationRequest

5 properties

JSON SCHEMA

Cycle

9 properties

JSON SCHEMA

CycleScore

4 properties

JSON SCHEMA

DiagnosticReportCreateRequest

2 properties

JSON SCHEMA

LabRequisition

6 properties

JSON SCHEMA

PaginatedCycleResponse

2 properties

JSON SCHEMA

PaginatedSleepResponse

2 properties

JSON SCHEMA

PartnerTokenRequest

4 properties

JSON SCHEMA

PartnerTokenResponse

3 properties

JSON SCHEMA

Patient

1 properties

JSON SCHEMA

PatientCore

1 properties

JSON SCHEMA

Recovery

7 properties

JSON SCHEMA

RecoveryCollection

2 properties

JSON SCHEMA

RecoveryScore

6 properties

JSON SCHEMA

ServiceRequest

6 properties

JSON SCHEMA

ServiceRequestStatusRequest

2 properties

JSON SCHEMA

Sleep

12 properties

JSON SCHEMA

SleepNeeded

4 properties

JSON SCHEMA

SleepScore

6 properties

JSON SCHEMA

SleepStageSummary

8 properties

JSON SCHEMA

SleepStreamDataPoint

7 properties

JSON SCHEMA

SleepStreamResponse

2 properties

JSON SCHEMA

UnilabsAppointment

4 properties

JSON SCHEMA

UnilabsCollectionAddress

5 properties

JSON SCHEMA

UnilabsPatient

10 properties

JSON SCHEMA

UserBasicProfile

4 properties

JSON SCHEMA

UserBodyMeasurement

3 properties

JSON SCHEMA

WorkoutCollection

2 properties

JSON SCHEMA

WorkoutScore

9 properties

JSON SCHEMA

WorkoutV2

12 properties

JSON SCHEMA

ZoneDurations

6 properties

JSON SCHEMA

Scroll for all 33

Examples 5

Example request and response payloads for these APIs.

Whoop Cycle Example

4 fields

EXAMPLE

Whoop Recovery Example

4 fields

EXAMPLE

Whoop Sleep Example

4 fields

EXAMPLE

Whoop User Profile Example

4 fields

EXAMPLE

Whoop Workout Example

4 fields

EXAMPLE

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Whoop Authentication

oauth2 · 2 schemes

SECURITY

Whoop Domain Security

TLSv1.3 · DMARC

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Whoop Scopes

7 scopes · authorizationCode/clientCredentials

7 scopes

SCOPES

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Whoop Agentic Access

21 operations · 6 acting · 1 human-in-the-loop

21 operations · 6 acting

AGENTIC

Resources

Documentation 1

Reference material describing how the API behaves

Documentation
Documentation

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess

Build 1

SDKs, sample code, and the tooling you integrate with

GitHubOrg
GitHubOrg

Access & Security 3

Authentication, authorization, and security posture

DomainSecurity
DomainSecurity
 Authentication
Authentication
 OAuthScopes
OAuthScopes

Operate 2

Status, limits, changes, and where to get help

StatusPage
StatusPage
 RateLimits
RateLimits

Commercial 3

Pricing, plans, and the legal terms of use

Pricing
Pricing
 Plans
Plans
 FinOps
FinOps

Company 3

The organization behind the API

Website
Website
 LinkedIn
LinkedIn
 Blog
Blog

Other 1

Properties that don't map to a standard resource type

X
X

Source (apis.yml)

apis.yml Raw ↑ 
aid: whoop
name: WHOOP
description: WHOOP is a fitness and recovery wearable platform providing a REST API for accessing sleep, recovery, strain,
  and workout metrics from the WHOOP band. The API uses OAuth 2.0 authorization code flow with Bearer tokens to allow developers
  to build applications that access member health and performance data including physiological cycles, sleep stages, recovery
  scores, strain, heart rate, body measurements, and workout records.
type: Index
accessModel:
  pricing: free
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Free · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/whoop.png
url: https://raw.githubusercontent.com/api-evangelist/whoop/refs/heads/main/apis.yml
created: '2026-06-13'
modified: '2026-06-13'
specificationVersion: '0.19'
tags:
- Fitness
- Wearables
- Health
- Recovery
- Sleep
- Workout
- Strain
- Heart Rate
- Performance
apis:
- aid: whoop:whoop-activity-id-mapping-api
  name: WHOOP Activity ID Mapping API
  description: Utility endpoints for activity ID mapping
  humanURL: https://developer.whoop.com/api/
  baseURL: https://api.prod.whoop.com
  tags:
  - Activity ID Mapping
  properties:
  - type: OpenAPI
    url: openapi/whoop-activity-id-mapping-api-openapi.yml
  - type: Documentation
    url: https://developer.whoop.com/docs/developing/overview/
  - type: OpenAPISource
    url: https://api.prod.whoop.com/developer/doc/openapi.json
  - type: OpenAPIArtifact
    url: openapi/whoop-openapi.yml
  - type: Vocabulary
    url: vocabulary/whoop-vocabulary.yml
  - type: JSONLDContext
    url: json-ld/whoop-context.jsonld
  - type: Authentication
    url: https://developer.whoop.com/docs/developing/oauth/
  - type: RateLimits
    url: https://developer.whoop.com/docs/developing/rate-limiting/
  - type: GettingStarted
    url: https://developer.whoop.com/docs/developing/getting-started/
  - type: GraphQL
    url: graphql/whoop-graphql.md
- aid: whoop:whoop-cycle-api
  name: WHOOP Cycle API
  description: The Cycle API from WHOOP — 3 operation(s) for cycle.
  humanURL: https://developer.whoop.com/api/
  baseURL: https://api.prod.whoop.com
  tags:
  - Cycle
  properties:
  - type: OpenAPI
    url: openapi/whoop-cycle-api-openapi.yml
  - type: Documentation
    url: https://developer.whoop.com/docs/developing/overview/
  - type: OpenAPISource
    url: https://api.prod.whoop.com/developer/doc/openapi.json
  - type: OpenAPIArtifact
    url: openapi/whoop-openapi.yml
  - type: Vocabulary
    url: vocabulary/whoop-vocabulary.yml
  - type: JSONLDContext
    url: json-ld/whoop-context.jsonld
  - type: Authentication
    url: https://developer.whoop.com/docs/developing/oauth/
  - type: RateLimits
    url: https://developer.whoop.com/docs/developing/rate-limiting/
  - type: GettingStarted
    url: https://developer.whoop.com/docs/developing/getting-started/
  - type: GraphQL
    url: graphql/whoop-graphql.md
- aid: whoop:whoop-partner-api
  name: WHOOP Partner API
  description: Endpoints for trusted WHOOP partner operations
  humanURL: https://developer.whoop.com/api/
  baseURL: https://api.prod.whoop.com
  tags:
  - Partner
  properties:
  - type: OpenAPI
    url: openapi/whoop-partner-api-openapi.yml
  - type: Documentation
    url: https://developer.whoop.com/docs/developing/overview/
  - type: OpenAPISource
    url: https://api.prod.whoop.com/developer/doc/openapi.json
  - type: OpenAPIArtifact
    url: openapi/whoop-openapi.yml
  - type: Vocabulary
    url: vocabulary/whoop-vocabulary.yml
  - type: JSONLDContext
    url: json-ld/whoop-context.jsonld
  - type: Authentication
    url: https://developer.whoop.com/docs/developing/oauth/
  - type: RateLimits
    url: https://developer.whoop.com/docs/developing/rate-limiting/
  - type: GettingStarted
    url: https://developer.whoop.com/docs/developing/getting-started/
  - type: GraphQL
    url: graphql/whoop-graphql.md
- aid: whoop:whoop-recovery-api
  name: WHOOP Recovery API
  description: The Recovery API from WHOOP — 2 operation(s) for recovery.
  humanURL: https://developer.whoop.com/api/
  baseURL: https://api.prod.whoop.com
  tags:
  - Recovery
  properties:
  - type: OpenAPI
    url: openapi/whoop-recovery-api-openapi.yml
  - type: Documentation
    url: https://developer.whoop.com/docs/developing/overview/
  - type: OpenAPISource
    url: https://api.prod.whoop.com/developer/doc/openapi.json
  - type: OpenAPIArtifact
    url: openapi/whoop-openapi.yml
  - type: Vocabulary
    url: vocabulary/whoop-vocabulary.yml
  - type: JSONLDContext
    url: json-ld/whoop-context.jsonld
  - type: Authentication
    url: https://developer.whoop.com/docs/developing/oauth/
  - type: RateLimits
    url: https://developer.whoop.com/docs/developing/rate-limiting/
  - type: GettingStarted
    url: https://developer.whoop.com/docs/developing/getting-started/
  - type: GraphQL
    url: graphql/whoop-graphql.md
- aid: whoop:whoop-sleep-api
  name: WHOOP Sleep API
  description: The Sleep API from WHOOP — 3 operation(s) for sleep.
  humanURL: https://developer.whoop.com/api/
  baseURL: https://api.prod.whoop.com
  tags:
  - Sleep
  properties:
  - type: OpenAPI
    url: openapi/whoop-sleep-api-openapi.yml
  - type: Documentation
    url: https://developer.whoop.com/docs/developing/overview/
  - type: OpenAPISource
    url: https://api.prod.whoop.com/developer/doc/openapi.json
  - type: OpenAPIArtifact
    url: openapi/whoop-openapi.yml
  - type: Vocabulary
    url: vocabulary/whoop-vocabulary.yml
  - type: JSONLDContext
    url: json-ld/whoop-context.jsonld
  - type: Authentication
    url: https://developer.whoop.com/docs/developing/oauth/
  - type: RateLimits
    url: https://developer.whoop.com/docs/developing/rate-limiting/
  - type: GettingStarted
    url: https://developer.whoop.com/docs/developing/getting-started/
  - type: GraphQL
    url: graphql/whoop-graphql.md
- aid: whoop:whoop-user-api
  name: WHOOP User API
  description: Endpoints for retrieving user profile and measurement data.
  humanURL: https://developer.whoop.com/api/
  baseURL: https://api.prod.whoop.com
  tags:
  - User
  properties:
  - type: OpenAPI
    url: openapi/whoop-user-api-openapi.yml
  - type: Documentation
    url: https://developer.whoop.com/docs/developing/overview/
  - type: OpenAPISource
    url: https://api.prod.whoop.com/developer/doc/openapi.json
  - type: OpenAPIArtifact
    url: openapi/whoop-openapi.yml
  - type: Vocabulary
    url: vocabulary/whoop-vocabulary.yml
  - type: JSONLDContext
    url: json-ld/whoop-context.jsonld
  - type: Authentication
    url: https://developer.whoop.com/docs/developing/oauth/
  - type: RateLimits
    url: https://developer.whoop.com/docs/developing/rate-limiting/
  - type: GettingStarted
    url: https://developer.whoop.com/docs/developing/getting-started/
  - type: GraphQL
    url: graphql/whoop-graphql.md
- aid: whoop:whoop-workout-api
  name: WHOOP Workout API
  description: The Workout API from WHOOP — 2 operation(s) for workout.
  humanURL: https://developer.whoop.com/api/
  baseURL: https://api.prod.whoop.com
  tags:
  - Workout
  properties:
  - type: OpenAPI
    url: openapi/whoop-workout-api-openapi.yml
  - type: Documentation
    url: https://developer.whoop.com/docs/developing/overview/
  - type: OpenAPISource
    url: https://api.prod.whoop.com/developer/doc/openapi.json
  - type: OpenAPIArtifact
    url: openapi/whoop-openapi.yml
  - type: Vocabulary
    url: vocabulary/whoop-vocabulary.yml
  - type: JSONLDContext
    url: json-ld/whoop-context.jsonld
  - type: Authentication
    url: https://developer.whoop.com/docs/developing/oauth/
  - type: RateLimits
    url: https://developer.whoop.com/docs/developing/rate-limiting/
  - type: GettingStarted
    url: https://developer.whoop.com/docs/developing/getting-started/
  - type: GraphQL
    url: graphql/whoop-graphql.md
common:
- type: AgenticAccess
  url: agentic-access/whoop-agentic-access.yml
- type: DomainSecurity
  url: security/whoop-domain-security.yml
- type: Authentication
  url: authentication/whoop-authentication.yml
- type: OAuthScopes
  url: scopes/whoop-scopes.yml
- type: Website
  url: https://www.whoop.com
- type: Documentation
  url: https://developer.whoop.com
- type: GitHubOrg
  url: https://github.com/WhoopInc
- type: LinkedIn
  url: https://www.linkedin.com/company/whoop
- type: Blog
  url: https://engineering.prod.whoop.com
- type: Pricing
  url: https://developer.whoop.com/docs/developing/getting-started/
- type: StatusPage
  url: https://status.whoop.com
- type: X
  url: https://x.com/whoop
- type: Plans
  url: plans/whoop-plans-pricing.yml
- type: RateLimits
  url: rate-limits/whoop-rate-limits.yml
- type: FinOps
  url: finops/whoop-finops.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com