---
title: "List upcoming webinars for the user"
method: GET
path: "/v1/webinars"
tags: ["webinars"]
---

# List upcoming webinars for the user

`GET /v1/webinars`

## Request

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

**Draft — not yet available.**

Returns the upcoming webinars available to the user, ordered by the start of their next session. A webinar is upcoming while at least one of its sessions hasn't ended.

A webinar has one or more events, such as the talks in a series. Each event runs in one or more sessions and may have resources, such as a PDF guide or a Thrive article. Every event and session of a returned webinar is included, including sessions that have ended. Past webinars are not returned: link users to `meta.pastWebinarsUrl`.

Users sign up and join in Thrive, through `links.signUp` and `links.attend`.

Call this endpoint with the user's own access token (`UserTokenAuth`). The token decides which webinars the user can see, so there is no parameter for it.

## Query parameters

- `tag` string
- `condition` string
- `chb` string
- `offset` integer
- `limit` integer
- `locale` string

## Response `200`

A page of upcoming webinars

- object
  - `data` WebinarItem[], required
    - `id` string, uuid, required: Stable webinar identifier
    - `name` string, required
    - `description` string, required
    - `locale` string, nullable, required: Served locale, not request echo
    - `tags` TaxonomyTerm[], required
      - `id` string, nullable, required: Stable identifier for the term; null where none exists
      - `slug` string, required
      - `name` string, nullable, required
    - `conditions` TaxonomyTerm[], required
      - `id` string, nullable, required: Stable identifier for the term; null where none exists
      - `slug` string, required
      - `name` string, nullable, required
    - `coreHealthBehaviors` TaxonomyTerm[], required
      - `id` string, nullable, required: Stable identifier for the term; null where none exists
      - `slug` string, required
      - `name` string, nullable, required
    - `events` WebinarEvent[], required: The parts of the webinar, in display order
      - `id` string, required: Unique within the webinar. Not yet guaranteed to stay the same over time, so don't store it.
      - `name` string, required
      - `description` string, nullable, required
      - `assets` AssetEntry[], required: The event image, as a `role: "image-featured"` entry
        - `role` 'captions' | 'transcript' | 'image-landscape' | 'image-portrait' | 'thumbnail-landscape' | 'thumbnail-portrait' | 'image-featured', required
        - `contentType` string, nullable, required
        - `url` string, uri, required
        - `alt` string, nullable, required
        - `sizes` object: Explicit size-variant URLs where they exist. Never derive variants by transforming URLs.
      - `resources` WebinarResource[], required: Supporting material for the event, in display order. May be empty.
        - `id` string, uuid, required: Stable resource identifier
        - `name` string, required
        - `description` string, nullable, required
        - `media` WebinarResourceMedia[], required
          - `kind` 'file' | 'link', required: `file` is a downloadable file, such as a PDF guide. `link` is a web page to open, such as a Thrive article.
          - `orientation` 'landscape' | 'portrait' | 'null', nullable, required: Always null for webinar resources
          - `contentType` string, nullable, required: MIME type where known. Null for `link`.
          - `url` string, uri, required
      - `sessions` WebinarSession[], required: Ascending by `startsAt`. Sessions that have ended are included.
        - `id` string, required: Unique within the webinar. Not yet guaranteed to stay the same over time, so don't store it.
        - `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.
    - `registration` WebinarRegistration, required: Whether the user has signed up for this webinar. One sign-up covers every session.
      - `status` 'notRegistered' | 'registered', required: More values may be added. Treat a value you don't recognise as `notRegistered`.
    - `links` WebinarLinks, required: Links into Thrive. They open through single sign-on and only work for the user the token was issued for.
      - `signUp` string, uri, required: Signs the user up for the webinar as soon as it is opened.
      - `attend` string, uri, required: The Thrive webinar page, listing every event and session, where the user joins a session. Never a direct link to the video meeting.
  - `meta` WebinarListMeta, 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.
    - `pastWebinarsUrl` string, uri, required: Thrive page listing past webinars and their recordings. Past webinars are not returned by this API.
  - `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 webinars, or the user is not in your organisation
- `422`: Invalid query parameters (e.g. negative offset, zero limit)
- `502`: Service temporarily unavailable

## Changes

- **2026-10-15** `a0a9a5e05e8c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/thriveglobal/apis/thrive-global-partner-api/changes/v1/webinars/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)
