WHwhoop
Cycle

GET /v2/cycle

Changed on

Get all physiological cycles for a user, paginated. Results are sorted by start time in descending order.

Request

  • Base URL
    https://api.prod.whoop.com/developer
  • Auth
    OAuth 2
    Authorization codehttps://api.prod.whoop.com/oauth/oauth2/auth
    Token URLhttps://api.prod.whoop.com/oauth/oauth2/token
    Scopesread:cycles
  • TypeScript
    A function with typed inputs. Its response is checked against the schema.

Query parameters

limitinteger

Limit on the number of cycles returned

startstring date-time

Return cycles that occurred after or during (inclusive) this time. If not specified, the response will not filter cycles by a minimum time.

endstring date-time

Return cycles that intersect this time or ended before (exclusive) this time. If not specified, end will be set to now.

nextTokenstring

Optional next token from the previous response to get the next page. If not provided, the first page in the collection is returned

Response

Successful request

next_tokenstring

A token that can be used on the next request to access the next page of records. If the token is not present, there are no more records in the collection.

Example response

{
  "records": [
    {
      "id": 93845,
      "user_id": 10129,
      "created_at": "2022-04-24T11:25:44.774Z",
      "updated_at": "2022-04-24T14:25:44.774Z",
      "start": "2022-04-24T02:25:44.774Z",
      "end": "2022-04-24T10:25:44.774Z",
      "timezone_offset": "-05:00",
      "score_state": "SCORED",
      "score": {
        "strain": 5.2951527,
        "kilojoule": 8288.297,
        "average_heart_rate": 68,
        "max_heart_rate": 141
      },
      "step_count": 8234
    }
  ],
  "next_token": "MTIzOjEyMzEyMw"
}

Changes