Get Registrants

HTTP Method: GET URL: /api/v3/events/{eventId}/registrants Authentication: Requires API Key in the request header. Authorization: The event must belong to the account associated with the API token. Returns 403 if the event belongs to a different account. Path Parameters:

Parameter	Type	Description
`eventId`	string	ID of the webinar event. For a live webinar, visit the schedule page and click “Copy event ID” in the three dots menu. For an on-demand webinar, visit the on-demand webinars list and click “Copy webinar ID” in the three dots menu.

Query Parameters:

Parameter	Type	Default	Description
`limit`	integer	100	Number of items per page (1–500)
`cursor`	string	—	Opaque cursor from `page.next_cursor` of a previous response. Used for pagination.
`sort`	string	`registeredAt`	Field to sort by. Allowed values: `registeredAt`, `email`, `name`
`order`	string	`desc`	Sort direction. Allowed values: `asc`, `desc`
`approved`	boolean	—	Filter by approval status (`true` / `false`). On-demand webinars have no approval flow, so this filter has no effect on them.
`participated`	boolean	—	Filter by whether the registrant joined the live session, or — for on-demand webinars — watched the recording
`search`	string	—	Free-text search across email, name, and last name
`updated_after`	string	—	Only return registrants registered after this date (ISO-8601). Useful for incremental syncing. Example: `2026-01-01T00:00:00Z`

Response: Paginated list of registrant objects for the specified event. Rate limit: Once every 1 second for unique requests. Pagination: This endpoint uses cursor-based pagination with a default page size of 100 registrants. To iterate through all results:

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

Status Codes:

200 OK Registrants retrieved successfully.
401 Unauthorized Authentication failed (missing or invalid API token).
403 Forbidden Event does not belong to this account.
404 Not Found Event not found.
500 Internal Server Error Unexpected server error.

On-Demand Webinars

The endpoint accepts an on-demand webinar ID in the eventId path parameter. The response schema, filters, sorting, pagination, authorization and rate limits are identical to live webinars, so existing integrations parse on-demand responses with no changes.

Notes:

participated is true once the registrant has watched more than 10 seconds of the recording — the same threshold as the “Watched” metric in on-demand analytics.

attendance_rate and duration report watch percentage and watch time. Both are null if the registrant has never watched.

join_url is the registrant’s personalized, tokenized watch URL.

approved is always true. On-demand webinars have no approval flow, and the field is kept for schema compatibility.

referrer returns "api" for registrants created through the Create Webinar Registrant endpoint.

Watch activity is reflected whenever it happens. A registrant who watches 30 days after registering returns updated participated, attendance_rate and duration values on subsequent calls.

updated_after filters by registration date only. Later watch activity does not change a registrant’s updated_after value, so an incremental sync will not surface registrants whose watch metrics changed after they registered. To keep watch data current, re-pull the full registrant list on a schedule.

While an on-demand webinar is unpublished, its public page and any issued join_url links return 404. Registrant data remains available through this endpoint, and the links work again once the webinar is republished.

Sample Request

GET /api/v3/events/69b5f9f8788fcc3897fd60e8/registrants HTTP/1.1
Host: platform.riverside.fm
Authorization: Bearer YOUR_API_KEY

Sample Request with filters

GET /api/v3/events/69b5f9f8788fcc3897fd60e8/registrants?limit=50&approved=true&sort=email&order=asc HTTP/1.1
Host: platform.riverside.fm
Authorization: Bearer YOUR_API_KEY

Sample Request for incremental sync

GET /api/v3/events/69b5f9f8788fcc3897fd60e8/registrants?updated_after=2026-03-15T00:00:00Z HTTP/1.1
Host: platform.riverside.fm
Authorization: Bearer YOUR_API_KEY

Sample Request with cursor pagination

GET /api/v3/events/69b5f9f8788fcc3897fd60e8/registrants?limit=50&cursor=MjAyNi0wMy0xNlQxNzo0Mzo1MC4wMDBaOjoxODYwNQ== HTTP/1.1
Host: platform.riverside.fm
Authorization: Bearer YOUR_API_KEY

Sample Response

{
  "event_id": "69b5f9f8788fcc3897fd60e8",
  "items": [
    {
      "first_name": "Ada",
      "last_name": "Lovelace",
      "email": "[email protected]",
      "registered_at": "2026-01-12T10:15:30.000Z",
      "approved": true,
      "join_url": "https://riverside.fm/studio/my-studio?audienceToken=abc-123",
      "participated": true,
      "attendance_rate": 87.5,
      "duration": "52:31",
      "referrer": "https://www.linkedin.com",
      "utm": {
        "source": "google",
        "medium": "cpc",
        "campaign": "webinar_launch",
        "term": "webinar",
        "content": "banner"
      },
      "custom_fields": {
        "Company": "Acme",
        "Phone": { "countryCode": "+1", "phoneNumber": "555555555" }
      }
    }
  ],
  "page": {
    "limit": 100,
    "next_cursor": "MjAyNi0wMy0xNlQxNzo0Mzo1MC4wMDBaOjoxODYwNQ==",
    "total_items": 350
  }
}

Sample Response for an on-demand webinar

{
  "event_id": "6a12c4d0788fcc3897fd7712",
  "items": [
    {
      "first_name": "Grace",
      "last_name": "Hopper",
      "email": "[email protected]",
      "registered_at": "2026-02-04T08:22:11.000Z",
      "approved": true,
      "join_url": "https://riverside.fm/webinar/6a12c4d0788fcc3897fd7712?token=abc123...",
      "participated": true,
      "attendance_rate": 42.3,
      "duration": "18:04",
      "referrer": "api",
      "custom_fields": {
        "Company": "Acme"
      }
    },
    {
      "first_name": "Alan",
      "last_name": "Turing",
      "email": "[email protected]",
      "registered_at": "2026-02-05T13:47:02.000Z",
      "approved": true,
      "join_url": "https://riverside.fm/webinar/6a12c4d0788fcc3897fd7712?token=def456...",
      "participated": false,
      "attendance_rate": null,
      "duration": null,
      "referrer": "https://www.linkedin.com",
      "custom_fields": {
        "Company": "Bletchley"
      }
    }
  ],
  "page": {
    "limit": 100,
    "next_cursor": null,
    "total_items": 2
  }
}

Response Fields

Field	Type	Description
`event_id`	string	The event ID from the request
`items`	array	List of registrant objects for this page
`page`	object	Pagination metadata
`page.limit`	number	The page size used for this request
`page.next_cursor`	string \| null	Opaque cursor to pass as `?cursor=` for the next page. `null` when there are no more pages.
`page.total_items`	number	Total number of registrants matching the filters

Registrant Object Fields

Field	Type	Nullable	Description
`first_name`	string	No	Registrant’s first name
`last_name`	string	Yes	Registrant’s last name
`email`	string	No	Registrant’s email address
`registered_at`	string	No	Timestamp when the registrant signed up (ISO-8601)
`approved`	boolean	No	Whether the registrant is approved to attend. Always `true` for on-demand webinars.
`join_url`	string	Yes	Unique join URL for this registrant. For on-demand webinars, the personalized tokenized watch URL.
`participated`	boolean	No	Whether the registrant actually joined the live session. For on-demand webinars, whether they watched more than 10 seconds of the recording.
`attendance_rate`	number	Yes	Percentage of the event the registrant attended (0–100). For on-demand webinars, the percentage of the recording watched. `null` if never watched.
`duration`	string	Yes	Time spent in the session, formatted as `MM:SS`. For on-demand webinars, total watch time. `null` if never watched.
`referrer`	string	Yes	Referrer URL if available. Returns `"api"` for registrants created through the Create Webinar Registrant endpoint.
`utm`	object	Yes	UTM tracking parameters (only present if any UTM value exists)
`utm.source`	string	Yes	UTM source
`utm.medium`	string	Yes	UTM medium
`utm.campaign`	string	Yes	UTM campaign
`utm.term`	string	Yes	UTM term
`utm.content`	string	Yes	UTM content
`custom_fields`	object	Yes	Key-value map of custom registration fields. Values can be string, boolean, or `{ countryCode, phoneNumber }`

Error Responses

Unauthorized (401)

{
  "message": "Unauthorized"
}

Forbidden (403)

{
  "message": "Event does not belong to this account"
}

Event Not Found (404)

{
  "message": "Event not found"
}

Getting Started

Endpoints Reference

Webhooks

Objects Reference

On-Demand Webinars

Sample Request

Sample Request with filters

Sample Request for incremental sync

Sample Response

Sample Response for an on-demand webinar

Response Fields

Registrant Object Fields

Error Responses

​On-Demand Webinars

​Sample Request

​Sample Request with filters

​Sample Request for incremental sync

​Sample Request with cursor pagination

​Sample Response

​Sample Response for an on-demand webinar

​Response Fields

​Registrant Object Fields

​Error Responses

On-Demand Webinars

Sample Request

Sample Request with filters

Sample Request for incremental sync

Sample Request with cursor pagination

Sample Response

Sample Response for an on-demand webinar

Response Fields

Registrant Object Fields

Error Responses