Search participants

Search every contact assigned to at least one session on the event in any participant role — the standard roles (speaker, chairperson, moderator) and any custom role configured for the event (Panelist, Coach, Author, …). This is the superset of POST /v1/event/{eventId}/speakers, which matches speakers only.

Each contact is returned once, however many sessions or roles it holds, with a roles array listing every role it has on the event and the session ids where it holds each one. Every other field is the same Contact shape POST /speakers returns, in the same order, with roles appended last. roles always describes the contact’s full set of roles on the event — it is not narrowed by the request filters, so a search filtered to the Moderator role still shows that a result is also a Speaker elsewhere on the program.

Filters. Every Search Speakers filter is accepted and behaves the same: createdAt, updatedAt, status (the session’s status), trackIds, levelIds, formatIds, languageIds, tagIds, plus sort and expand. Categorization filters are evaluated against the top-level session, so a participant on a subsession matches when the subsession’s parent satisfies the filter. Each array filter needs at least one id — [] is a 400 naming the field; omit the property to apply no filter.

Three filters are specific to this endpoint:

• roleIds — return only participants holding at least one of the given roles, standard or custom. Get the ids from GET /v1/event/{eventId}/participant-roles.
• roleSlugs — the same, by role slug (speaker, chairperson, moderator, or a custom role’s slug). Use this to get every speaker without resolving ids per event, or on older events where roles have roleId: null.
• email — exact, case-insensitive match on the contact’s email. An unknown address returns an empty results array with totalResults: 0, not an error. For a single-record lookup that answers 404 instead, use GET /v1/event/{eventId}/participants?email=.

Roles on older events. Roles are stored per event. An event that has never been opened in the Sessions editor may not have its standard roles created yet; its participants are still returned, but a standard role on such an event has roleId: null (with roleName, slug and coreRole filled in) and cannot be matched by roleIds until the roles exist — filter by roleSlugs instead. GET .../participant-roles returns an empty list for such an event.