GET sessions/getSpeakers

GET /api/v2/sessions/getSpeakers

Returns speaker profile information for an event. Can return a single speaker filtered by internal ID, external ID, or email — or all speakers for the event when no filter is provided.


Authentication

Authorization: Bearer <your_api_key>

Endpoint

GET /api/v2/sessions/getSpeakers

Query Parameters

Parameter

Type

Required

Description

event_id

integer

Yes

The ID of the event to retrieve speakers for

id

integer

No

Internal account ID of a specific speaker. Takes priority over external_id and email

external_id

string

No

External identifier of a specific speaker. Used when id is not provided

email

string

No

Email address of a specific speaker. Used when neither id nor external_id is provided

If none of id, external_id, or email are provided, all speakers for the event are returned.


Speaker Object Fields

Field

Type

Nullable

Description

id

integer

No

The account ID

speaker_id

integer

No

Same as id

external_id

string

Yes

External identifier for this account, if set

email

string

No

Email address

first_name

string

No

First name

last_name

string

No

Last name

title

string

Yes

Honorific title (e.g. "Dr.")

job_title

string

Yes

Job title or position

description

string

No

Speaker biography

photo

string

No

URL of the speaker's photo

linkedin_page

string

Yes

LinkedIn profile URL

facebook_page

string

Yes

Facebook page URL

twitter_page

string

Yes

Twitter profile URL

speaking_sessions

array[integer]

No

Array of session IDs at which this speaker is presenting


Error Responses

HTTP Code

Condition

Error Message

400

event_id is missing

Missing required parameter: event_id

400

event_id or id is not a valid integer

Param must be a integer: <field>

400

email is not a valid email address

Param email must be a valid email

400

id provided but account not found or not a speaker

Invalid Speaker ID

400

external_id provided but account is not a speaker

Account with external_id <external_id> is not speaker

400

email provided but account is not a speaker

Account with email <email> is not speaker

400

external_id or email provided but no matching account found

Invalid Speaker external_id or email

403

Missing or invalid API key

Forbidden


Example Request — All Speakers

Bash
curl -X GET "https://your-event-domain.com/api/v2/sessions/getSpeakers?event_id=7" \
  -H "Authorization: Bearer your_api_key_here"

Example Request — Single Speaker by ID

Bash
curl -X GET "https://your-event-domain.com/api/v2/sessions/getSpeakers?event_id=7&id=18626" \
  -H "Authorization: Bearer your_api_key_here"