Search languages

POST/v1/event/{eventId}/languages

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

Returns a paginated list of languages configured for an event.

Request example

cURL

curl --request POST \
  --url 'https://public-api.sessionboard.com/v1/event/{eventId}/languages' \
  --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"
  ]
}'

JavaScript

const response = await fetch('https://public-api.sessionboard.com/v1/event/{eventId}/languages', {
  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);

Python

import requests

response = requests.request(
    "POST",
    "https://public-api.sessionboard.com/v1/event/{eventId}/languages",
    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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => "https://public-api.sessionboard.com/v1/event/{eventId}/languages",
    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;

Go

package main

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

func main() {
  req, _ := http.NewRequest("POST", "https://public-api.sessionboard.com/v1/event/{eventId}/languages", 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))
}

Java

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://public-api.sessionboard.com/v1/event/{eventId}/languages"))
    .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

RegionUS Region — https://public-api.sessionboard.comEU Region — https://public-api-eu.sessionboard.com

Authorization

Send asAPI token (x-access-token)OAuth access token (Bearer)

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

{ "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" ] }

POST

Send request

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

200application/json

OK

• resultsLanguage[]
  Show child attributes

  • idstring<uuid>
  • event_idinteger
  • namestring
  • orderinteger
  • created_atstring
  • updated_atstring
• 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

200

{
  "results": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "event_id": 123,
      "name": "<string>",
      "order": 123,
      "created_at": "<string>",
      "updated_at": "<string>"
    }
  ],
  "pagination": {
    "currentPage": 1,
    "pageSize": 25,
    "totalPages": 4,
    "totalResults": 97
  }
}