Skip to content

List the sessions and submissions

GET/v1/organization/{orgId}/sessions-workspace/events/{eventId}/sessions

US Region: https://public-api.sessionboard.com · EU Region: https://public-api-eu.sessionboard.com

The event's sessions with their speakers, decision, time, room, track and sponsor tags, and whether each came through the call (submitted). Reads only. Requires read:sessions. Refused for a key restricted to particular events. Also at GET /v1/sessions-workspace/events/{eventId}/sessions.

Request example

Terminal window
curl --request GET \
--url 'https://public-api.sessionboard.com/v1/organization/{orgId}/sessions-workspace/events/{eventId}/sessions' \
--header 'x-access-token: <api-token>'

Try it

Authorization

Your token stays in this page. It is sent only to the region above and is never saved; it is gone when you leave or reload the page.

Path parameters
Query parameters
GET

Authorizations

  • x-access-tokenstringheader

    Organization API token. Generate from Organization Settings → API Tokens.

  • AuthorizationBearer <token>headeror

    OAuth 2.1 access token. Obtained via the OAuth PKCE flow at /oauth/token.

Send one of these. See Authentication.

Path parameters

  • orgIdstringpathrequired

    Your organization ID. Any other organization returns 404.

  • eventIdintegerpathrequired

    The Sessions event ID.

Query parameters

  • viewstringquery

    submissions: only what came through the call.

    Allowed values
    "all", "submissions"
  • statusstringquery

    pending is undecided.

    Allowed values
    "pending", "accepted", "declined"

Responses

200application/json

OK

  • successboolean
  • payloadobject
    Show child attributes
    • sessionsSessionsWorkspaceSession[]
      Show child attributes
      • idstring<uuid>
      • titlestring
      • descriptionstring | null

        Plain text.

      • statusstring

        pending (undecided), accepted or declined.

      • track_idstring | null
      • format_idstring | null
      • room_idstring | null
      • starts_atstring<date-time> | null
      • ends_atstring<date-time> | null
      • submittedboolean

        Came through the call for speakers.

      • created_atstring<date-time>
      • speakersSessionsWorkspaceSessionSpeaker[]
        Show child attributes
        • contact_idstring<uuid>
        • namestring | null
        • emailstring | null
        • titlestring | null
        • rolestring | null
      • sponsor_idsstring<uuid>[]

401

Missing, invalid or expired token.

403application/json

  • SCOPE_REQUIRED: the token lacks read:sessions.
  • ORG_WIDE_TOKEN_REQUIRED: the key is restricted to particular events; use a key without an event restriction.
  • FORBIDDEN: the token's user is not an active member of the organization.
  • errorstring
    Allowed values
    "VALIDATION_ERROR", "SCOPE_REQUIRED", "ORG_WIDE_TOKEN_REQUIRED", "FORBIDDEN", "NOT_FOUND", "CONFLICT", "QUOTA_EXCEEDED"
  • messagestringrequired
  • codestring

    A more specific reason: enterprise_only, trial_ended, plan_ended, in_use.

  • upgradestring

    With enterprise_only: what needs a bigger plan or the platform (events, speakers, review_plans, forms, …).

404application/json

NOT_FOUND: orgId is not the token's organization, or the event, session or sponsor is not in it.

  • errorstring
    Allowed values
    "VALIDATION_ERROR", "SCOPE_REQUIRED", "ORG_WIDE_TOKEN_REQUIRED", "FORBIDDEN", "NOT_FOUND", "CONFLICT", "QUOTA_EXCEEDED"
  • messagestringrequired
  • codestring

    A more specific reason: enterprise_only, trial_ended, plan_ended, in_use.

  • upgradestring

    With enterprise_only: what needs a bigger plan or the platform (events, speakers, review_plans, forms, …).

429

The token's request limit (100 requests per 15 minutes by default) or, for writes, its daily write quota. Wait Retry-After seconds.

  • Retry-Afterintegerheader

    Seconds to wait before retrying.

Response examples

{
"success": true,
"payload": {
"sessions": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>",
"description": "<string>",
"status": "<string>",
"track_id": "<string>",
"format_id": "<string>",
"room_id": "<string>",
"starts_at": "2026-01-15T09:30:00Z",
"ends_at": "2026-01-15T09:30:00Z",
"submitted": true,
"created_at": "2026-01-15T09:30:00Z",
"speakers": [
{
"contact_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"email": "<string>",
"title": "<string>",
"role": "<string>"
}
],
"sponsor_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
]
}
]
}
}