Search exhibitors

POST/v1/event/{eventId}/exhibitors

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

Search and filter exhibitors within an event. Returns the account records carrying the Exhibitor role on this event — an account holding both roles is returned by both searches, and contacts are never returned.

Request example

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

resultsExhibitor[]
Show child attributes
- idstring
- friendly_idstring
- friendly_id_rawinteger
- namestring
- descriptionstring
- logo_image_urlstring
- banner_image_urlstring
- phonestring
- address_line_1string
- address_line_2string
- address_citystring
- address_statestring
- address_postal_codestring
- address_coutnrystring
  Country (note: field name contains a known typo preserved for backwards compatibility).
- facebook_urlstring
- instagram_urlstring
- linkedin_urlstring
- snapchat_usernamestring
- tiktok_usernamestring
- twitter_urlstring
- website_urlstring
- created_atstring
- updated_atstring<date-time>
  When the exhibitor last changed, from any source, including Public API creates, updates and bulk writes. Send it back as updated_at on an update for optimistic concurrency; the write returns the new value.
- custom_fieldsCustomFieldValue[]
  Show child attributes
  - idstring
  - namestring
  - valuestring | boolean | null
    The formatted field value, or null when the field is empty. Numeric field types (number, currency, percent, quantity, formula) serialize a stored zero as its formatted value (for example "0") — null means the field has no value, not that the value is zero.
    
    checkbox fields serialize as the strings "Yes" (checked) and "No" (explicitly unchecked); a checkbox that was never set is null. Writes take boolean true / false.
    
    datetime fields serialize as ISO 8601. On event custom fields (GET /v1/events?expand=custom_fields) the value is event-local time with the event's UTC offset (for example 2026-08-15T09:00:00-03:00), falling back to the raw UTC instant (2026-08-15T12:00:00.000Z) when the event has no valid timezone. On session, speaker, sponsor, and exhibitor custom fields the value is the raw UTC instant.
    
    date (date-only) fields serialize as M-DD-YYYY: month without a leading zero, day with one, four-digit year (for example 9-22-2026 for 22 September 2026, 3-04-2026 for 4 March 2026). This is not ISO 8601; parse it with that exact pattern.
  - typestring
  - internal_namestring
  - created_atstring
- translated_fieldsTranslatedField[]
  Show child attributes
  - idstring
  - namestring
  - typestring
  - parent_field_idstring
  - parent_field_sourcestring
  - parent_field_namestring
  - parent_field_internal_namestring
  - translated_languagestring
  - valuestring
- contactsAccountContact[]
  Show child attributes
  - idstring
  - friendly_idstring
  - friendly_id_rawinteger
  - full_namestring
  - first_namestring
  - last_namestring
  - emailstring
  - photo_urlstring
    URL of the contact's headshot. Images larger than 2 MB are delivered resized from this URL, scaled to fit within 2400 x 2400 pixels (a PNG may arrive as WebP for clients that accept it). The uploaded file is stored unchanged; for full-resolution originals use the bulk download tools in Sessionboard, such as Download Headshots (Contacts, More menu).
  - company_namestring
  - titlestring
  - aboutstring
  - is_primaryboolean
  - contact_created_atstring
  - contact_updated_atstring
  - relationship_created_atstring
  - relationship_updated_atstring
- admin_urlstring<uri> | null
  Deep link to this entity in the Sessionboard admin UI.
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": "c3d4e5f6-a7b8-9012-cdef-123456789012",
      "friendly_id": "EXH-7",
      "friendly_id_raw": 7,
      "name": "InnovateTech Labs",
      "description": "Showcasing next-generation event technology solutions.",
      "logo_image_url": "https://cdn.sessionboard.com/logos/innovatetech.png",
      "address_city": "Chicago",
      "address_state": "IL",
      "address_coutnry": "US",
      "website_url": "https://www.innovatetech.example.com",
      "created_at": "2024-01-12T10:00:00Z",
      "updated_at": "2024-03-01T14:00:00Z",
      "custom_fields": [],
      "translated_fields": [],
      "contacts": []
    }
  ],
  "pagination": {
    "currentPage": 1,
    "pageSize": 25,
    "totalPages": 4,
    "totalResults": 97
  }
}

Search exhibitors

Request example

Try it

Authorizations

Path parameters

Query parameters

Request body

Responses

200application/json

401

404

Response examples

200`application/json`