---
title: "List the user's coaching sessions"
method: GET
path: "/v1/coaching/sessions"
tags: ["coaching"]
---

# List the user's coaching sessions

`GET /v1/coaching/sessions`

## Request

- Base URL: `https://partners-api.thriveglobal.com`
- URL: `https://partners-api.thriveglobal.com/v1/coaching/sessions`
- Auth: HTTP bearer

**Draft — not yet available.**

The user's coaching sessions in a time window, for example upcoming sessions for reminders or past sessions for history. With no parameters, returns sessions that haven't ended yet, soonest first. For past sessions, send `to` set to the current time and `order=desc`. Cancelled and missed sessions are included; check `status`.

Call this endpoint with the user's own access token (`UserTokenAuth`). The token identifies the user, so there is no user parameter.

## Query parameters

- `from` string, date-time
- `to` string, date-time
- `order` 'asc' | 'desc'
- `offset` integer
- `limit` integer

## Response `200`

A page of coaching sessions

- object
  - `data` CoachingSession[], required
    - `id` string, uuid, required: Stable identifier. It stays the same when the session is rescheduled.
    - `status` 'scheduled' | 'completed' | 'cancelled' | 'missed', required: `scheduled`: booked and not yet ended. `completed`: the session took place. `cancelled`: the session was cancelled by the user or the coach, or the coach couldn't attend. `missed`: the user didn't attend.
    - `startsAt` string, date-time, required: UTC. Show it in the user's time zone.
    - `endsAt` string, date-time, required: UTC. Show it in the user's time zone.
    - `coach` CoachingCoach, required: The coach for the session. Every session has one.
      - `firstName` string, required
  - `meta` PaginationMeta, required: Applied pagination values — after defaulting and clamping, not what was requested.
    - `pagination` object, required
      - `offset` integer, required
      - `limit` integer, required
      - `total` integer, nullable, required: Best-effort display data; null when a total is not available. `links.next != null` is the authoritative "more results exist" signal.
  - `links` PaginationLinks, required: Opaque pagination URLs — follow `next` until it is null; do not parse them. All three attributes are always present (null when there is no such page).
    - `self` string, required
    - `next` string, nullable, required
    - `prev` string, nullable, required

## Other responses

- `401`: Unauthorized — missing, invalid, or expired token
- `403`: Forbidden — the token does not grant access to coaching, or the user is not in your organisation
- `422`: Invalid query parameters (e.g. `from` later than `to`, a malformed date-time, unknown `order`, negative offset, zero limit)
- `502`: Service temporarily unavailable

## Changes

- **2026-10-24** `c18a31de927e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/thriveglobal/apis/thrive-global-partner-api/changes/v1/coaching/sessions/get.md)

---

[API](https://skmtc.dev/thriveglobal/apis/thrive-global-partner-api.md) - [All operations](https://skmtc.dev/thriveglobal/apis/thrive-global-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/thriveglobal/apis/thrive-global-partner-api/revisions/c18a31de927e?raw)
