Search organization contacts

POST/v1/organization/{orgId}/contacts

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

Search and filter contacts across the organization.

Request example

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

orgId*

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

orgIdstring<uuid>pathrequired
The organization ID (UUID).

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`

resultsContact[]
Show child attributes
- idstring
- friendly_idstring
- full_namestring
- first_namestring
- last_namestring
- emailstring
- created_atstring
- updated_atstring<date-time>
  When the contact last changed, from any source: an admin or portal edit, a sync, or a Public API write (create, update or bulk). Send it back as updated_at on PUT /v1/event/{eventId}/contacts/{contactId} or a bulk update for optimistic concurrency; the write returns the new value.
- 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
- phone_homestring
- phone_mobilestring
- address_line_1string
- address_line_2string
- address_citystring
- address_statestring
- address_postal_codestring
- address_countrystring
- website_urlstring
- linkedin_urlstring
- twitter_urlstring
- facebook_urlstring
- honorificstring
- salutationstring
- pronounsstring
- genderstring
- past_companiesstring
- educational_affiliationstring
- highest_level_of_educationstring
- ethnicitystring
- languagesstring
- speaker_scorestring
- organization_contactstring
- speaker_feestring
- availabilitystring
- preferred_session_formatstring
- annual_revenuestring
- headcountstring
- years_in_operationstring
- organization_structurestring
- industrystring
- global_regionstring
- audience_typestring
- target_age_rangestring
- topic_expertisestring
- brandstring
- translated_fieldsTranslatedField[]
  Show child attributes
  - idstring
  - namestring
  - typestring
  - parent_field_idstring
  - parent_field_sourcestring
  - parent_field_namestring
  - parent_field_internal_namestring
  - translated_languagestring
  - valuestring
- 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
- 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

Organization not found

Response examples

{
  "results": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "friendly_id": "SPK-42",
      "full_name": "Dr. Jane Smith",
      "first_name": "Jane",
      "last_name": "Smith",
      "email": "jane.smith@university.edu",
      "created_at": "2023-11-01T10:00:00Z",
      "updated_at": "2024-02-15T16:30:00Z",
      "photo_url": "https://cdn.sessionboard.com/photos/jane-smith.jpg",
      "company_name": "State University",
      "title": "Professor of Computer Science",
      "about": "Dr. Smith is a leading researcher in distributed systems.",
      "address_city": "Austin",
      "address_state": "TX",
      "address_country": "US",
      "honorific": "Dr.",
      "pronouns": "she/her",
      "topic_expertise": "Distributed Systems, Cloud Computing",
      "custom_fields": [],
      "translated_fields": []
    }
  ],
  "pagination": {
    "currentPage": 1,
    "pageSize": 25,
    "totalPages": 4,
    "totalResults": 97
  }
}

Search organization contacts

Request example

Try it

Authorizations

Path parameters

Query parameters

Request body

Responses

200application/json

401

404

Response examples

200`application/json`