Skip to content

Get a sponsor

GET/v1/event/{eventId}/sponsors/{sponsorId}

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

Retrieve a single sponsor by ID.

Request example

Terminal window
curl --request GET \
--url 'https://public-api.sessionboard.com/v1/event/{eventId}/sponsors/{sponsorId}' \
--header 'x-access-token: <api-token>'

Try it

Authorization

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
Query parameters
GET

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.

  • sponsorIdstringpathrequired

    The sponsor ID.

Query parameters

  • expandstring[]query

    Expand records with additional data.

    Possible values:

    • translated_fields — includes the translated_fields array on records when the event has language variants configured.
    • subsession_details — applies to session responses. Each subsession inside parent.subsessions[] is returned with full parent-session field parity (status, custom_status, custom_fields, chairpersons, moderators, sponsors, exhibitors, tags, language, track, level, room, is_public, external_url, client_session_id, ceu_credits, capacity, source) instead of the default minimal shape. Subsessions inherit is_abstract, composition_status, and optional composition from the parent. Not required when calling GET /v1/event/{eventId}/sessions/{sessionId} with a subsession UUID — that endpoint always returns the full shape at the top level.
    • linked_sources — include sessions that are linked as composition sources (excluded from list/search results by default).
    • composition — attach a full composition object with target and source details on each returned session. Recommended for single-session GET; use cautiously on broad searches.

    A single value can be passed directly, and multiple values repeat the parameter — all of these are accepted:

    • ?expand=composition
    • ?expand=translated_fields&expand=composition
    • ?expand[]=translated_fields&expand[]=composition
    Allowed values
    "translated_fields", "subsession_details", "linked_sources", "composition"

Responses

200application/json

OK

A sponsor associated with an event.

  • 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 sponsor 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.

401

Unauthorized

404

No sponsor with this id on this event. A record that exists but does not hold the sponsor role — a contact, or a group linked only as the other role — is also a 404 here; look it up on the endpoint for the role it holds.

Response examples

{
"id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"friendly_id": "SPON-3",
"friendly_id_raw": 3,
"name": "TechCorp Global",
"description": "Platinum sponsor and technology partner.",
"logo_image_url": "https://cdn.sessionboard.com/logos/techcorp.png",
"phone": "+1-555-0100",
"address_city": "San Francisco",
"address_state": "CA",
"address_coutnry": "US",
"website_url": "https://www.techcorp.example.com",
"linkedin_url": "https://www.linkedin.com/company/techcorp",
"created_at": "2024-01-05T08:00:00Z",
"updated_at": "2024-02-20T12:00:00Z",
"custom_fields": [],
"translated_fields": [],
"contacts": []
}

Get release notes by email

A short digest on the days something new goes live — each change with a link to its note in the release notes. No marketing, and one click to stop.

Company email addresses only. We’ll send one email to confirm it’s you. Already use Sessionboard? You can also turn this on under Community → What’s new.