Agenda API

the agenda api is an endpoint that returns agenda information for a given event id it returns a list of sessions, along with their locations, session speaker information, and filtering attributes (traits and trait groups) that allow you to present agenda information on event websites, event apps, and more the endpoint is setup and ready to be directly consumed by clients such as websites or event apps without any additional infrastructure of caching required on your end global data and image cdn and caching is available out of the box the agenda api must be enabled on a per event basis in the jomablue portal cors a note on cors for front end consumers of this api within the jomablue portal, cors configurations can be configured on a per event basis to allow your front ends to directly consume data from jomablue apis endpoint get /api/agenda/{event id} this request returns json formatted data about the sessions in the requested event (see the sample request and response) response codes 200 accepted request stored and queued for processing 404 not found returned if the api is disabled for the requested event response attributes a description of each attribute in the event payload is below data object id string a unique identifier alphanumeric (upper and lower case), hyphens, forward slash and underscores no whitespace name string event name alphanumeric (upper and lower case), special characters and whitespace start date timestamp timestamp in the following format 2025 12 08t22 00 00 000000z end date timestamp timestamp in the following format 2025 12 08t22 00 00 000000z locations array list of all venue locations for the event id integer unique identifier for the location name string name of the location/room description string | null location description alphanumeric (upper and lower case), special characters and whitespace null if not specified color string | null hex color code for the location null if not specified sessions array list of all sessions for the event id integer unique identifier for the session name string session name/title description string | null session description in html format null if not specified start time timestamp timestamp in the following format 2025 12 08t11 00 00 000000z finish time timestamp timestamp in the following format 2025 12 08t11 30 00 000000z restricted boolean indicates whether the session has restricted access promo text string | null promotional text for the session null if not specified promo logo string | null url to the promotional logo image null if not specified location id integer references a location id from the locations array speakers array list of speakers for this session can be empty id integer unique identifier for the speaker title string | null professional title of the speaker null if not specified first name string speaker's first name last name string speaker's last name company string | null company the speaker represents null if not specified description string | null speaker biography in html format null if not specified image string | null url to the speaker's profile image null if not specified trait types array custom trait types/categories associated with the session can be empty id integer unique identifier for the trait type name string name of the trait type (e g , "content type") traits array list of traits within this trait type id integer unique identifier for the trait name string name of the trait (e g , "workshop") color string | null hex color code for the trait null if not specified text color string | null hex color code for text null if not specified sample request and response curl x get https //{your instance} jomablue com/api/agenda/{event id} \\ h "content type application/json" \\ h "accept application/json"{ "data" { "id" "example/event/123", "name" "annual tech summit 2025", "start date" "2025 03 15t09 00 00 000000z", "end date" "2025 03 17t18 00 00 000000z", "locations" \[ { "id" 1, "name" "main auditorium", "description" "our largest venue space with capacity for 500 attendees ", "log exits" false, "color" "#007fc4" }, { "id" 2, "name" "breakout room a", "description" "intimate space perfect for workshops and small group discussions ", "log exits" true, "color" "#8cc740" } ], "sessions" \[ { "id" 1, "name" "opening keynote", "description" "\join us for an inspiring keynote address to kick off the summit \", "start time" "2025 03 15t09 00 00 000000z", "finish time" "2025 03 15t10 00 00 000000z", "restricted" false, "promo text" "don't miss our opening keynote address!", "promo logo" "https //example com/images/keynote promo jpg", "location id" 1, "speakers" \[ { "id" 1, "title" "ceo", "first name" "jane", "last name" "smith", "company" "tech innovations inc", "description" "\jane smith is a visionary leader with 20 years of experience in the technology industry \", "image" "https //example com/images/speakers/jane smith jpg" } ], "trait types" \[ { "id" 1, "name" "session type", "traits" \[ { "id" 1, "name" "keynote", "color" "#253344", "text color" null } ] } ] }, { "id" 2, "name" "workshop advanced react patterns", "description" "\a hands on workshop exploring advanced patterns in react development \", "start time" "2025 03 15t11 00 00 000000z", "finish time" "2025 03 15t12 30 00 000000z", "restricted" true, "promo text" "learn cutting edge react techniques from industry experts ", "promo logo" "https //example com/images/react workshop jpg", "location id" 2, "speakers" \[ { "id" 2, "title" "cto", "first name" "john", "last name" "doe", "company" "web solutions ltd", "description" "\john doe is a renowned expert in modern web development frameworks \", "image" "https //example com/images/speakers/john doe jpg" }, { "id" 3, "title" "", "first name" "sarah", "last name" "johnson", "company" "frontend masters", "description" "\sarah johnson specializes in react architecture and performance optimization \", "image" "https //example com/images/speakers/sarah johnson jpg" } ], "trait types" \[ { "id" 1, "name" "session type", "traits" \[ { "id" 2, "name" "workshop", "color" "#8cc740", "text color" "#ffffff" } ] }, { "id" 2, "name" "experience level", "traits" \[ { "id" 3, "name" "advanced", "color" "#e6694d", "text color" null } ] } ] } ] } } considerations date/time stamps all datetimes are formatted as iso 8601 (e g 2025 03 15t09 00 00 000000z ) traits these are logical groupings of sessions by arbitary attributes you can think of 'traits' as filters you would apply to a list of session (like 'tech' 'devops' 'sales' 'marketing' etc) and trait groups as a grouping of filters, like 'technical' and 'management' where 'tech' and 'devops' would sit under 'technical' and 'sales' and 'marketing' sit under 'management' traits and trait groups are configured in the jomablue portal