Get Events

HTTP Method: GET URL: /api/v3/events Authentication: Requires API Key in the request header. Authorization: Account-level. Returns every scheduled event in the account associated with the API token. Query Parameters:

Parameter	Type	Default	Description
`event_type`	string	—	Filter by event type. Allowed values: `session`, `webinar`. A `session` is a scheduled studio session with no registration form; a `webinar` has one.
`status`	string	—	Filter by event state. Allowed values: `upcoming`, `live`, `ended`.
`from`	string	—	ISO-8601 timestamp. Only events whose `start_time` is at or after this instant. Example: `2026-10-01T00:00:00Z`
`to`	string	—	ISO-8601 timestamp. Only events whose `start_time` is at or before this instant. Example: `2026-10-31T23:59:59Z`
`studio_id`	string	—	Only events scheduled in this studio. Studio IDs are returned by List Workspace.
`updated_after`	string	—	ISO-8601 timestamp. Only events created or updated after this instant. Useful for incremental syncing. Example: `2026-09-01T00:00:00Z`
`cursor`	string	—	Opaque cursor from `next_cursor` of a previous response. Used for pagination.
`limit`	integer	20	Number of items per page (1–500)

All filters are optional and can be combined. Response: Paginated list of event objects, newest scheduled start first. Rate limit: Once every 1 second for unique requests. Pagination: This endpoint uses cursor-based pagination with a default page size of 20 events. To iterate through all results:

Make the first request without a cursor parameter
If next_cursor is not null, make another request with cursor set to that value
Repeat until next_cursor is null

Keep every filter identical across the pages of a single walk. A cursor is only valid for the filter set it was issued with. Status Codes:

200 OK Events retrieved successfully.
400 Bad Request Invalid query parameter, or a cursor that was not issued by this endpoint.
401 Unauthorized Authentication failed (missing or invalid API token).
404 Not Found The endpoint is not enabled for this account.
429 Too Many Requests Rate limit exceeded.
500 Internal Server Error Unexpected server error.

Notes:

Results are ordered by start_time descending — the newest scheduled event first, past events further down the list.

Recurring events return one object per occurrence, each with its own id. Every occurrence id is valid input to Get Registrants and Create Webinar Registrant.

Deleted events are never returned.

On-demand webinars are not scheduled events and are not listed by this endpoint. Their IDs still work with the registrant endpoints — copy the ID from the on-demand webinars list.

status is derived at request time: upcoming before the scheduled start, live between the scheduled start and end, and ended after the scheduled end or once the session has been recorded.

updated_after tracks changes to the event itself — title, schedule, studio. New registrations do not change an event’s update timestamp, so use Get Registrants to sync audience data.

livestream_destinations is populated as soon as the destination is scheduled, before the event goes live. Custom RTMP destinations are not included — they are not part of event scheduling.

Access is granted per account. If the endpoint returns 404 with a valid API key, speak to your customer success manager.

Sample Request

GET /api/v3/events HTTP/1.1
Host: platform.riverside.com
Authorization: Bearer YOUR_API_KEY

Sample Request with filters

GET /api/v3/events?event_type=webinar&status=upcoming&limit=50 HTTP/1.1
Host: platform.riverside.com
Authorization: Bearer YOUR_API_KEY

Sample Request for a date range in one studio

GET /api/v3/events?from=2026-10-01T00:00:00Z&to=2026-10-31T23:59:59Z&studio_id=507f1f77bcf86cd799439011 HTTP/1.1
Host: platform.riverside.com
Authorization: Bearer YOUR_API_KEY

Sample Request for incremental sync

GET /api/v3/events?updated_after=2026-09-01T00:00:00Z HTTP/1.1
Host: platform.riverside.com
Authorization: Bearer YOUR_API_KEY

Sample Request with cursor pagination

GET /api/v3/events?limit=50&cursor=eyJzIjoiMjAyNi0wOS0yNFQxNDowMDowMC4wMDBaIiwiaSI6IjlmMWM0YjJlLTBkM2EtNGM3Ny1iMWU1LTJhNmY4YzBkNGU5MSJ9 HTTP/1.1
Host: platform.riverside.com
Authorization: Bearer YOUR_API_KEY

Sample Response

{
  "data": [
    {
      "id": "69b5f9f8788fcc3897fd60e8",
      "name": "Q4 Product Launch",
      "event_type": "webinar",
      "status": "upcoming",
      "start_time": "2026-10-01T16:00:00.000Z",
      "end_time": "2026-10-01T17:00:00.000Z",
      "studio_id": "507f1f77bcf86cd799439011",
      "studio_name": "Main Studio",
      "registration_enabled": true,
      "registrants_count": 142,
      "registration_url": "https://riverside.fm/webinar/registration/eyJldmVudElkIjoiNjliNWY5Zjg3ODhmY2MzODk3ZmQ2MGU4Iiwic2x1ZyI6InByb2R1Y3Qtd2ViaW5hcnMifQ==",
      "livestream_destinations": [
        { "platform": "youtube", "url": "https://youtube.com/watch?v=abc123" },
        { "platform": "linkedin", "url": "https://linkedin.com/events/7250000000000000000" }
      ],
      "created_date": "2026-09-01T12:00:00.000Z"
    },
    {
      "id": "69b5fa41788fcc3897fd6104",
      "name": "Weekly Team Recording",
      "event_type": "session",
      "status": "ended",
      "start_time": "2026-09-24T14:00:00.000Z",
      "end_time": "2026-09-24T15:00:00.000Z",
      "studio_id": "507f1f77bcf86cd799439011",
      "studio_name": "Main Studio",
      "registration_enabled": false,
      "registrants_count": null,
      "registration_url": null,
      "livestream_destinations": [],
      "created_date": "2026-08-12T09:30:00.000Z"
    }
  ],
  "next_cursor": "eyJzIjoiMjAyNi0wOS0yNFQxNDowMDowMC4wMDBaIiwiaSI6IjlmMWM0YjJlLTBkM2EtNGM3Ny1iMWU1LTJhNmY4YzBkNGU5MSJ9"
}

Response Fields

Field	Type	Description
`data`	array	List of event objects for this page
`next_cursor`	string \| null	Opaque cursor to pass as `?cursor=` for the next page. `null` when there are no more pages.

Event Object Fields

Field	Type	Nullable	Description
`id`	string	No	Event ID. Valid input to the registrant endpoints. Matches the ID shown by “Copy event ID” in the Planner.
`name`	string	No	Event title as set in the Planner
`event_type`	string	No	`session` or `webinar`
`status`	string	No	`upcoming`, `live`, or `ended`
`start_time`	string	No	Scheduled start (ISO-8601, UTC)
`end_time`	string	No	Scheduled end (ISO-8601, UTC)
`studio_id`	string	No	ID of the studio hosting the event
`studio_name`	string	Yes	Name of the hosting studio. `null` if the studio is no longer available.
`registration_enabled`	boolean	No	Whether the event has a registration form. Always `false` for sessions.
`registrants_count`	number	Yes	Number of registrants on the event’s audience list. `null` when `registration_enabled` is `false`.
`registration_url`	string	Yes	Public sign-up page for the webinar — the same link the `webinar.created` webhook delivers. Points at the direct-join page when the webinar does not require registration. Safe to publish; it is never a per-attendee join link. `null` when `registration_enabled` is `false`.
`livestream_destinations`	array	No	Social destinations scheduled for this event. Empty array when none are configured.
`livestream_destinations[].platform`	string	No	Destination platform, e.g. `youtube`, `linkedin`, `facebook`
`livestream_destinations[].url`	string	Yes	Public viewing URL of the scheduled broadcast, when the platform provides one
`created_date`	string	No	When the event was created (ISO-8601)

Error Responses

Invalid query parameter or cursor (400)

{
  "statusCode": 400,
  "message": "Invalid cursor",
  "error": "Bad Request"
}

Unauthorized (401)

{
  "message": "Unauthorized"
}

Endpoint not enabled for this account (404)

{
  "statusCode": 404,
  "message": "Not Found"
}

Rate limit exceeded (429)

{
  "statusCode": 429,
  "message": "ThrottlerException: Too Many Requests"
}

Getting Started

Endpoints Reference

Webhooks

Objects Reference

Sample Request

Sample Request with filters

Sample Request for a date range in one studio

Sample Request for incremental sync

Sample Response

Response Fields

Event Object Fields

Error Responses

​Sample Request

​Sample Request with filters

​Sample Request for a date range in one studio

​Sample Request for incremental sync

​Sample Request with cursor pagination

​Sample Response

​Response Fields

​Event Object Fields

​Error Responses

Sample Request

Sample Request with filters

Sample Request for a date range in one studio

Sample Request for incremental sync

Sample Request with cursor pagination

Sample Response

Response Fields

Event Object Fields

Error Responses