Search session statuses

POST/v1/event/{eventId}/session-statuses

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

Returns a paginated list of custom session status definitions for an event.

Request example

curl --request POST \
  --url 'https://public-api.sessionboard.com/v1/event/{eventId}/session-statuses' \
  --header 'x-access-token: <api-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "filters": {
    "createdAt": {
      "before": "2026-01-15T09:30:00Z",
      "after": "2026-01-15T09:30:00Z"
    },
    "updatedAt": {
      "before": "2026-01-15T09:30:00Z",
      "after": "2026-01-15T09:30:00Z"
    },
    "status": "accepted"
  },
  "sort": {
    "createdAt": {
      "sort": "asc",
      "order": 123
    },
    "updatedAt": {
      "sort": "asc",
      "order": 123
    }
  },
  "expand": [
    "translated_fields"
  ]
}'

const response = await fetch('https://public-api.sessionboard.com/v1/event/{eventId}/session-statuses', {
  method: 'POST',
  headers: {
    "x-access-token": "<api-token>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "filters": {
      "createdAt": {
        "before": "2026-01-15T09:30:00Z",
        "after": "2026-01-15T09:30:00Z"
      },
      "updatedAt": {
        "before": "2026-01-15T09:30:00Z",
        "after": "2026-01-15T09:30:00Z"
      },
      "status": "accepted"
    },
    "sort": {
      "createdAt": {
        "sort": "asc",
        "order": 123
      },
      "updatedAt": {
        "sort": "asc",
        "order": 123
      }
    },
    "expand": [
      "translated_fields"
    ]
  }),
});

const data = await response.json();
console.log(data);

import requests

response = requests.request(
    "POST",
    "https://public-api.sessionboard.com/v1/event/{eventId}/session-statuses",
    headers={
        "x-access-token": "<api-token>",
        "Content-Type": "application/json"
    },
    json={
        "filters": {
            "createdAt": {
                "before": "2026-01-15T09:30:00Z",
                "after": "2026-01-15T09:30:00Z"
            },
            "updatedAt": {
                "before": "2026-01-15T09:30:00Z",
                "after": "2026-01-15T09:30:00Z"
            },
            "status": "accepted"
        },
        "sort": {
            "createdAt": {
                "sort": "asc",
                "order": 123
            },
            "updatedAt": {
                "sort": "asc",
                "order": 123
            }
        },
        "expand": [
            "translated_fields"
        ]
    },
)

print(response.json())

<?php

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => "https://public-api.sessionboard.com/v1/event/{eventId}/session-statuses",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_POSTFIELDS => '{
  "filters": {
    "createdAt": {
      "before": "2026-01-15T09:30:00Z",
      "after": "2026-01-15T09:30:00Z"
    },
    "updatedAt": {
      "before": "2026-01-15T09:30:00Z",
      "after": "2026-01-15T09:30:00Z"
    },
    "status": "accepted"
  },
  "sort": {
    "createdAt": {
      "sort": "asc",
      "order": 123
    },
    "updatedAt": {
      "sort": "asc",
      "order": 123
    }
  },
  "expand": [
    "translated_fields"
  ]
}',
    CURLOPT_HTTPHEADER => [
        "x-access-token: <api-token>",
        "Content-Type: application/json",
    ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

package main

import (
  "fmt"
  "io"
  "net/http"
  "strings"
)

func main() {
  req, _ := http.NewRequest("POST", "https://public-api.sessionboard.com/v1/event/{eventId}/session-statuses", strings.NewReader(`{
  "filters": {
    "createdAt": {
      "before": "2026-01-15T09:30:00Z",
      "after": "2026-01-15T09:30:00Z"
    },
    "updatedAt": {
      "before": "2026-01-15T09:30:00Z",
      "after": "2026-01-15T09:30:00Z"
    },
    "status": "accepted"
  },
  "sort": {
    "createdAt": {
      "sort": "asc",
      "order": 123
    },
    "updatedAt": {
      "sort": "asc",
      "order": 123
    }
  },
  "expand": [
    "translated_fields"
  ]
}`))
  req.Header.Add("x-access-token", "<api-token>")
  req.Header.Add("Content-Type", "application/json")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)

  fmt.Println(string(body))
}

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://public-api.sessionboard.com/v1/event/{eventId}/session-statuses"))
    .header("x-access-token", "<api-token>")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{\n  \"filters\": {\n    \"createdAt\": {\n      \"before\": \"2026-01-15T09:30:00Z\",\n      \"after\": \"2026-01-15T09:30:00Z\"\n    },\n    \"updatedAt\": {\n      \"before\": \"2026-01-15T09:30:00Z\",\n      \"after\": \"2026-01-15T09:30:00Z\"\n    },\n    \"status\": \"accepted\"\n  },\n  \"sort\": {\n    \"createdAt\": {\n      \"sort\": \"asc\",\n      \"order\": 123\n    },\n    \"updatedAt\": {\n      \"sort\": \"asc\",\n      \"order\": 123\n    }\n  },\n  \"expand\": [\n    \"translated_fields\"\n  ]\n}"))
    .build();

HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

System.out.println(response.body());

Try it

Region

Authorization

Send as

Token

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

eventId*

Query parameters

page

pageSize

Body application/json

POST

Response headers

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

eventIdintegerpathrequired
The event ID.

Query parameters

pageintegerquery
Page number for pagination.
Default
1
Minimum
1
Maximum
999
pageSizeintegerquery
Number of results per page.

The event-settings list endpoints (tags, tracks, levels, formats, rooms, languages, statuses) also accept the older spelling page_size, and used to accept only that — a request sending pageSize silently got the default 25. Both now work, pageSize wins when both are sent, and on these endpoints a value outside 1–100 is clamped rather than rejected. Everywhere else pageSize is the only spelling.
Default
25
Minimum
1
Maximum
100

Request body

application/json

Common search request body used across multiple endpoints.

filtersobject
Show child attributes
- createdAtDateRangeFilter
  Filter by a date range using before and/or after bounds.
  Show child attributes
  - beforestring<date-time>
    Return records before this date-time.
  - afterstring<date-time>
    Return records after this date-time.
- updatedAtDateRangeFilter
  Filter by a date range using before and/or after bounds.
  Show child attributes
  - beforestring<date-time>
    Return records before this date-time.
  - afterstring<date-time>
    Return records after this date-time.
- statusstring
  Filter by session status (applicable to session searches).
  Allowed values
  "accepted", "accept_queue", "pending", "decline_queue", "declined"
sortSortOptions
Nested sort keys matching the search POST body (createdAt.sort, not a flat order enum). Each key is optional.
Show child attributes
- createdAtNestedSortField
  One sort key. sort is the direction; order is the priority when multiple keys are set (lower numbers apply first).
  Show child attributes
  - sortstring
    Allowed values
    "asc", "desc"
  - orderinteger
- updatedAtNestedSortField
  One sort key. sort is the direction; order is the priority when multiple keys are set (lower numbers apply first).
  Show child attributes
  - sortstring
    Allowed values
    "asc", "desc"
  - orderinteger
expandstring[]
Expand records with additional data. See the Expand parameter for linked_sources and composition details.
Allowed values
"translated_fields", "subsession_details", "linked_sources", "composition"

Example

{
  "filters": {
    "createdAt": {
      "before": "2026-01-15T09:30:00Z",
      "after": "2026-01-15T09:30:00Z"
    },
    "updatedAt": {
      "before": "2026-01-15T09:30:00Z",
      "after": "2026-01-15T09:30:00Z"
    },
    "status": "accepted"
  },
  "sort": {
    "createdAt": {
      "sort": "asc",
      "order": 123
    },
    "updatedAt": {
      "sort": "asc",
      "order": 123
    }
  },
  "expand": [
    "translated_fields"
  ]
}

Responses

200`application/json`

resultsSessionCustomStatus[]
Show child attributes
- idstring
- namestring
- statusstring
  Approval state this custom label maps onto. Stored NOT NULL, so it is always present on a status created through this API.
  Allowed values
  "pending", "accepted", "declined", "accept_queue", "decline_queue"
- status_namestring | null
- colorstring
- orderinteger
- is_customboolean
- created_atstring | null
- created_by_user_idinteger | null
- created_by_user_namestring | null
paginationPagination
Pagination metadata returned with POST search responses. The event-settings GET lists return the same numbers under snake_case keys — see ListPagination.
Show child attributes
- currentPageinteger
- pageSizeinteger
- totalPagesinteger
- totalResultsinteger

401

Unauthorized

404

Event not found

Response examples

{
  "results": [
    {
      "id": "<string>",
      "name": "<string>",
      "status": "pending",
      "status_name": "<string>",
      "color": "<string>",
      "order": 123,
      "is_custom": true,
      "created_at": "<string>",
      "created_by_user_id": 123,
      "created_by_user_name": "<string>"
    }
  ],
  "pagination": {
    "currentPage": 1,
    "pageSize": 25,
    "totalPages": 4,
    "totalResults": 97
  }
}

Search session statuses

Request example

Try it

Authorizations

Path parameters

Query parameters

Request body

Responses

200application/json

401

404

Response examples

200`application/json`