Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

WHOOP Partner API

Endpoints for trusted WHOOP partner operations

WHOOP Partner API is one of 7 APIs that WHOOP publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Partner. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, rate-limit docs, and a getting-started guide.

This API exposes 7 operations across 7 paths, and defines 13 schemas. It is described by OpenAPI 3.0.1.

Requests are made against a single base URL, https://api.prod.whoop.com/developer.

7 operations 7 paths 13 schemas 2 GET2 PATCH3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
Base URL
https://api.prod.whoop.com
Authentication
OAuth 2.0, OAuth 2.0
Resource Areas
1

Authentication & Security 2

WHOOP Partner API declares 2 security schemes for authenticating requests. It supports OAuth 2.0 (OAuth) using the authorizationCode flow, exposing 6 scopes. It supports OAuth 2.0 (Trusted Partner) using the clientCredentials flow, exposing 1 scope.

Paths & Operations 7

Across 7 paths, the API surfaces 7 operations — 2 GET, 2 PATCH, 3 POST. Each is listed below with its method, path, parameters, and response codes.

Partner 7

Endpoints for trusted WHOOP partner operations

POST
/v2/partner/development/add-test-data
Generate test data for partner development
addTestData → 204404500
GET
/v2/partner/requisition/{id}
Get a lab requisition by ID
getLabRequisitionById 1 param → 200404
GET
/v2/partner/service-request/{id}
Get a service request by ID
getServiceRequestById 1 param → 200404
POST
/v2/partner/token
Request a partner client token
requestToken body → 200401
PATCH
/v2/partner/requisition/{id}/status
Update lab requisition service request statuses
updateLabRequisitionStatus 1 param body → 204404
PATCH
/v2/partner/service-request/{id}/status
Update service request status
updateServiceRequestStatus 1 param body → 200404
POST
/v2/partner/service-request/{id}/results
Create diagnostic report results for a service request
uploadDiagnosticReportResults 1 param body → 201404

Schemas 13

The contract defines 13 schemas that model the data the API accepts and returns. The most detailed are UnilabsPatient (10 properties), ServiceRequest (6 properties), LabRequisition (6 properties), UnilabsCollectionAddress (5 properties). Each schema is shown below with its type and property counts.

Appointment
object
Appointment information
2 properties 2 required
Patient
object
1 property 1 required
PartnerTokenResponse
object
3 properties
UnilabsAppointment
object
4 properties 2 required
ServiceRequestStatusRequest
object
2 properties
PartnerTokenRequest
object
4 properties 2 required
ServiceRequest
object
6 properties 4 required
UnilabsCollectionAddress
object
The collection address for this appointment
5 properties 3 required
PatientCore
object
Patient information
1 property 1 required
UnilabsPatient
object
10 properties 4 required
CreateObservationRequest
object
optional list of observations to attach to the diagnostic report
5 properties
LabRequisition
object
6 properties 6 required
DiagnosticReportCreateRequest
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

whoop-partner-api-openapi.yml Raw ↑

Other APIs WHOOP publishes across the network.

WHOOP Activity ID Mapping API
WHOOP Cycle API
WHOOP Recovery API
WHOOP Sleep API
WHOOP User API
WHOOP Workout API