Skip to main content
This reference documents every endpoint available in the Sessionboard Public API. Endpoint pages are generated from our OpenAPI specification and include request parameters, response schemas, and example payloads.

​
Base URLs

RegionBase URL
UShttps://public-api.sessionboard.com
EUhttps://public-api-eu.sessionboard.com
Use the base URL corresponding to the region where your organization’s data is hosted.

​
Authentication

All requests require an x-access-token header containing a valid API token. See Authentication for details on generating and managing tokens. 
curl -H "x-access-token: YOUR_TOKEN" https://public-api.sessionboard.com/v1/events

​
Common Patterns

​
Pagination

Search endpoints accept page and pageSize parameters and return a pagination object in the response. The default page size is 25 and the maximum is 100.

​
Filtering

POST-based search endpoints accept filter criteria in the request body. Refer to each endpoint’s documentation for available filter fields.

​
Sorting

POST-based search endpoints accept a sort object in the request body to control result ordering. Sort by createdAt or updatedAt with asc or desc direction.

​
Expanding Records

Some endpoints support an expand query parameter to include additional data in the response. Currently, the supported expansion is translated_fields, which returns translated versions of text fields when your event has translations enabled.

​
Error Codes

Status CodeDescription
200Success. The response body contains the requested data.
400Bad Request. The request body or parameters are invalid. Check the error message for details.
401Unauthorized. The x-access-token header is missing or the token is invalid.
403Forbidden. The token does not have the required scope for this endpoint.
404Not Found. The requested resource does not exist.
429Too Many Requests. You are being rate limited. Retry after a short delay with exponential backoff.
500Internal Server Error. An unexpected error occurred. Contact support if the issue persists.