---
title: "Get an upcoming webinar by id"
method: GET
path: "/v1/webinars/{id}"
tags: ["webinars"]
---

# Get an upcoming webinar by id

`GET /v1/webinars/{id}`

## Request

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

**Draft — not yet available.**

Returns one upcoming webinar, with the same shape and the same rules as the list, for example to refresh a reminder before it fires. Returns `404` when the webinar does not exist, has no session that hasn't ended, or is not available to the user.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `locale` string

## Response `200`

The webinar

- object
  - `data` WebinarItem, required: **Draft.** An upcoming webinar: one the user can attend that has at least one session that hasn't ended. Users sign up once per webinar, then join any of its sessions from the Thrive webinar page (`links.attend`). Fields may be added; ignore fields you don't recognise.
    - `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.

## 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
- `404`: No upcoming webinar available to the user exists for the id
- `422`: Invalid id (must be a UUID) or query parameters
- `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/:id/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)
