--- title: "Look up a stream by ID" method: GET path: "/streams/id/{streamDataSource}:{streamId}" tags: ["Streams"] --- # Look up a stream by ID `GET /streams/id/{streamDataSource}:{streamId}` ## Request - Base URL: `https://api.data.jambase.com/v3` - URL: `https://api.data.jambase.com/v3/streams/id/{streamDataSource}:{streamId}` - Auth: HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) Retrieve a single livestream by its JamBase ID — or directly by a supported third-party ID with no ID-mapping step. ## Path parameters - `streamDataSource` 'jambase', required: Data source slugs to use for Stream IDs - `streamId` string, required ## Query parameters - `expandExternalIdentifiers` boolean - `expandArtistSameAs` boolean ## Response `200` A single Stream (`Stream`). - object: A single stream response - `success` boolean: A successful response. - `stream` Stream: A generic thing - `name` string, required: The name of the item - `identifier` string, required: A unique identifier of the item - `url` string, uri, required: URL of the item - `image` string, uri: URL of an illustrative image, such as a press photo or logo. Most images are owned by third parties and JamBase grants no rights in them. Display by URL or from your own cache, refreshed when the URL changes. See https://data.jambase.com/api/docs/images. Please note that `image` may not be provided for all schemas that include `Thing` (for example `Organization`). - `sameAs` URL[]: URL of a reference Web page that unambiguously indicates the item's identity - `@type` 'URL' - `identifier` 'officialSite' | 'facebook' | 'twitter' | 'instagram' | 'youtube' | 'musicbrainz' | 'spotify' | 'androidApp' | 'iosApp': The type of the external URL - `url` string, uri: The URL of the external link. - `datePublished` string, iso-8601: The date the Event first appeared in ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that 'datePublished' may not be provided for all Schemas that include `Thing` (e.g. `Organization`) - `dateModified` string, iso-8601: The date the Event was last updated in ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that 'dateModified' may not be provided for all Schemas that include `Thing` (e.g. `Organization`). \ Indexing timestamps for Concert / Festival / Stream / MusicGroup / MusicVenue live on `datePublished` and `dateModified`. The sibling `x-createdOnDate` and `x-updatedOnDate` fields are scoped to data-source / `Organization` responses (e.g. ticket vendors, performance-rights organizations) and are not present on Event-derived schemas. - `eventStatus` 'scheduled' | 'postponed' | 'rescheduled' | 'cancelled', required: The scheduling status of a live event. This is separate from `deletionStatus`, which appears only on tombstone rows: - `scheduled` — expected to happen at the current `startDate`; show normally. - `postponed` — delayed with no confirmed replacement date yet; keep the row, label it postponed, and avoid promising the current date. - `rescheduled` — moved to a confirmed new date; keep the row, update the date, and use `previousStartDate` when present. - `cancelled` — will not take place as scheduled but remains a live catalog row; keep it for history and joins, then hide it or clearly label it in upcoming views. Always persist `eventStatus` on upsert. None of these values means the row was removed from the catalog. - `startDate` string, iso-8601, required: The start date and time of the item using ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that `startDate` is returned based on the venue's local time but without an offset. You can find the timezone at `event > location > address > x-timezone` if you need to do any conversions. - `endDate` string, iso-8601: The end date of the item using ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that `endDate` is returned based on the venue's local time but without an offset. You can find the timezone at `event > location > address > x-timezone` if you need to do any conversions. - `previousStartDate` string, iso-8601: For rescheduled events, the previously scheduled start date using ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that `previousStartDate` is returned based on the venue's local time but without an offset. You can find the timezone at `event > location > address > x-timezone` if you need to do any conversions. - `doorTime` string, iso-8601: The time admission will commence in local time using ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that `doorTime` is returned based on the venue's local time but without an offset. You can find the timezone at `event > location > address > x-timezone` if you need to do any conversions. - `location` MusicVenue, required: A generic thing - `name` string: The name of the item - `identifier` string: A unique identifier of the item - `url` string, uri: URL of the item - `image` string, uri: URL of an illustrative image, such as a press photo or logo. Most images are owned by third parties and JamBase grants no rights in them. Display by URL or from your own cache, refreshed when the URL changes. See https://data.jambase.com/api/docs/images. Please note that `image` may not be provided for all schemas that include `Thing` (for example `Organization`). - `sameAs` URL[]: URL of a reference Web page that unambiguously indicates the item's identity - `@type` 'URL' - `identifier` 'officialSite' | 'facebook' | 'twitter' | 'instagram' | 'youtube' | 'musicbrainz' | 'spotify' | 'androidApp' | 'iosApp': The type of the external URL - `url` string, uri: The URL of the external link. - `datePublished` string, iso-8601: The date the Event first appeared in ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that 'datePublished' may not be provided for all Schemas that include `Thing` (e.g. `Organization`) - `dateModified` string, iso-8601: The date the Event was last updated in ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that 'dateModified' may not be provided for all Schemas that include `Thing` (e.g. `Organization`). \ Indexing timestamps for Concert / Festival / Stream / MusicGroup / MusicVenue live on `datePublished` and `dateModified`. The sibling `x-createdOnDate` and `x-updatedOnDate` fields are scoped to data-source / `Organization` responses (e.g. ticket vendors, performance-rights organizations) and are not present on Event-derived schemas. - `deletionStatus` 'deleted' | 'trashed' | 'merged': Present ONLY on tombstone rows returned by delta polls of currently sourced core feeds (requests that include `dateModifiedFrom`). This removal discriminator is separate from the live scheduling field `eventStatus`: - `deleted` — permanently removed; drop the cached row. - `trashed` — soft-deleted (events only; not an `eventStatus`). Treat the same as `deleted` and drop the cached row. - `merged` — folded into another record; repoint cached references to `mergedInto`. A tombstone row carries only `@type`, `identifier`, `deletionStatus`, `deletedAt`, `dateModified`, and (when `merged`) `mergedInto`. Tombstones count toward `perPage` and `pagination.totalItems` and are appended after live rows. For `deleted` / `trashed`, retention is 90 days from the visible-at `dateModified`; `merged` tombstones never expire. `deletedAt` is the true removal time and can be earlier than `dateModified` after a delayed backfill. Queries without `dateModifiedFrom` never return tombstones. Since 2026-10-29, delta queries filtered by artist or venue carry only matching tombstones: on events, `artistId` matches an artist in the removed event's lineup and `venueId` its venue, both as recorded when the event was removed (a `merged` event matches on the removed event, not the surviving one); on artists and venues, a merged record matches a filter on its own identifier. Their `pagination.totalItems` / `totalPages` count live rows plus the matching tombstones. Removals with no recorded artist or venue (mostly from before 2026-10-29) and deltas filtered by `artistSlug`, `artistName`, `venueSlug`, or `venueName` carry none. To see every removal, run one unfiltered `dateModifiedFrom` sweep (geo and date filters still carry all tombstones), or treat a `400 identifier_invalid` single-record lookup as removed. Current source coverage: events (`deleted`, `trashed`, `merged`), festivals (`deleted`), artists / venues / festival collections (`merged`), and no stream tombstones. - `deletedAt` string, iso-8601: The true upstream time when the record left the catalog, in ISO 8601. Present only on tombstone rows. This can be earlier than `dateModified` after a delayed backfill: `dateModified` is the later visible-at timestamp used for delta matching, ordering, and `deleted` / `trashed` retention. - `mergedInto` string: On a `merged` tombstone (see `deletionStatus`), the `identifier` of the surviving record this one was folded into. Repoint cached references from `identifier` to `mergedInto`. - `maximumAttendeeCapacity` number: The total number of individuals that may attend an event or venue. - `address` PostalAddress: A postal address, typically for a MusicVenue - `@type` 'PostalAddress' - `streetAddress` string: The street address - `addressLocality` string: The city/locality in which the place is in - `postalCode` string: The postal code - `addressRegion` State: A State, Region, or Province. \ Note 1: Available for United States, Canada, and Australia only. \ Note 2: The `country` and `x-numUpcomingEvents` nodes are only provided in the Geography lookup endpoints, not as part of `addressRegion` within a Concert, Festival, or Stream. - `@type` 'State' - `identifier` 'US-AL' | 'US-AK' | 'US-AZ' | 'US-AR' | 'US-CA' | 'US-CO' | 'US-CT' | 'US-DE' | 'US-FL' | 'US-GA' | 'US-HI' | 'US-ID' | 'US-IL' | 'US-IN' | 'US-IA' | 'US-KS' | 'US-KY' | 'US-LA' | 'US-ME' | 'US-MD' | 'US-MA' | 'US-MI' | 'US-MN' | 'US-MS' | 'US-MO' | 'US-MT' | 'US-NE' | 'US-NV' | 'US-NH' | 'US-NJ' | 'US-NM' | 'US-NY' | 'US-NC' | 'US-ND' | 'US-OH' | 'US-OK' | 'US-OR' | 'US-PA' | 'US-RI' | 'US-SC' | 'US-SD' | 'US-TN' | 'US-TX' | 'US-UT' | 'US-VT' | 'US-VA' | 'US-WA' | 'US-WV' | 'US-WI' | 'US-WY' | 'US-DC' | 'US-AS' | 'US-GU' | 'US-MP' | 'US-PR' | 'US-UM' | 'US-VI' | 'AU-ACT' | 'AU-NSW' | 'AU-NT' | 'AU-QLD' | 'AU-SA' | 'AU-TAS' | 'AU-VIC' | 'AU-WA' | 'CA-AB' | 'CA-BC' | 'CA-MB' | 'CA-NB' | 'CA-NL' | 'CA-NS' | 'CA-NT' | 'CA-NU' | 'CA-ON' | 'CA-PE' | 'CA-QC' | 'CA-SK' | 'CA-YT', iso-3166-2: A State code in ISO 3166-2 format [[docs](https://en.wikipedia.org/wiki/ISO_3166-2)]. - `name` string: The name of the State - `alternateName` string: The indentifier without the Country code prefix - `country` Country: A Country. - `@type` 'Country' - `identifier` 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BR' | 'BS' | 'BT' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'US' | 'UY' | 'UZ' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'XD' | 'XG' | 'XK' | 'XP' | 'XR' | 'XS' | 'XW' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW', iso-3166-alpha-2: The Country code in ISO 3166-1 alpha-2 format [[docs](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)]. - `name` string: The name of the Country Area - `alternateName` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATF' | 'ATG' | 'AUS' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MOZ' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'URY' | 'USA' | 'UZB' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XGZ' | 'XKS' | 'XPR' | 'XQZ' | 'XSP' | 'XSV' | 'XWB' | 'XXD' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE', iso-3166-alpha-3: The Country code in ISO 3166-1 alpha-3 format [[docs](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3)]. - `x-numUpcomingEvents` number: The number of upcoming events in this Country. \ Note: this is only provided in the Geography lookup endpoints, not as part of a location within a Concert, Festival, or Stream. - `x-numUpcomingEvents` number: The number of upcoming events in this State. \ Note: this is only provided in the Geography lookup endpoints, not as part of a location within a Concert, Festival, or Stream. - `addressCountry` Country: A Country. - `@type` 'Country' - `identifier` 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BR' | 'BS' | 'BT' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'US' | 'UY' | 'UZ' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'XD' | 'XG' | 'XK' | 'XP' | 'XR' | 'XS' | 'XW' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW', iso-3166-alpha-2: The Country code in ISO 3166-1 alpha-2 format [[docs](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)]. - `name` string: The name of the Country Area - `alternateName` 'ABW' | 'AFG' | 'AGO' | 'AIA' | 'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'ASM' | 'ATF' | 'ATG' | 'AUS' | 'AZE' | 'BDI' | 'BEL' | 'BEN' | 'BFA' | 'BGD' | 'BGR' | 'BHR' | 'BHS' | 'BIH' | 'BLM' | 'BLR' | 'BLZ' | 'BMU' | 'BOL' | 'BRA' | 'BRB' | 'BRN' | 'BTN' | 'BWA' | 'CAF' | 'CAN' | 'CCK' | 'CHE' | 'CHL' | 'CHN' | 'CIV' | 'CMR' | 'COD' | 'COG' | 'COK' | 'COL' | 'COM' | 'CPV' | 'CRI' | 'CUB' | 'CUW' | 'CXR' | 'CYM' | 'CYP' | 'CZE' | 'DEU' | 'DJI' | 'DMA' | 'DNK' | 'DOM' | 'DZA' | 'ECU' | 'EGY' | 'ERI' | 'ESH' | 'ESP' | 'EST' | 'ETH' | 'FIN' | 'FJI' | 'FLK' | 'FRA' | 'FRO' | 'FSM' | 'GAB' | 'GBR' | 'GEO' | 'GGY' | 'GHA' | 'GIB' | 'GIN' | 'GLP' | 'GMB' | 'GNB' | 'GNQ' | 'GRC' | 'GRD' | 'GRL' | 'GTM' | 'GUF' | 'GUM' | 'GUY' | 'HKG' | 'HND' | 'HRV' | 'HTI' | 'HUN' | 'IDN' | 'IMN' | 'IND' | 'IOT' | 'IRL' | 'IRN' | 'IRQ' | 'ISL' | 'ISR' | 'ITA' | 'JAM' | 'JEY' | 'JOR' | 'JPN' | 'KAZ' | 'KEN' | 'KGZ' | 'KHM' | 'KIR' | 'KNA' | 'KOR' | 'KWT' | 'LAO' | 'LBN' | 'LBR' | 'LBY' | 'LCA' | 'LIE' | 'LKA' | 'LSO' | 'LTU' | 'LUX' | 'LVA' | 'MAC' | 'MAF' | 'MAR' | 'MCO' | 'MDA' | 'MDG' | 'MDV' | 'MEX' | 'MHL' | 'MKD' | 'MLI' | 'MLT' | 'MMR' | 'MNE' | 'MNG' | 'MNP' | 'MOZ' | 'MRT' | 'MSR' | 'MTQ' | 'MUS' | 'MWI' | 'MYS' | 'MYT' | 'NAM' | 'NCL' | 'NER' | 'NFK' | 'NGA' | 'NIC' | 'NIU' | 'NLD' | 'NOR' | 'NPL' | 'NRU' | 'NZL' | 'OMN' | 'PAK' | 'PAN' | 'PCN' | 'PER' | 'PHL' | 'PLW' | 'PNG' | 'POL' | 'PRI' | 'PRK' | 'PRT' | 'PRY' | 'PYF' | 'QAT' | 'REU' | 'ROU' | 'RUS' | 'RWA' | 'SAU' | 'SDN' | 'SEN' | 'SGP' | 'SGS' | 'SHN' | 'SLB' | 'SLE' | 'SLV' | 'SMR' | 'SOM' | 'SPM' | 'SRB' | 'SSD' | 'STP' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'SWZ' | 'SXM' | 'SYC' | 'SYR' | 'TCA' | 'TCD' | 'TGO' | 'THA' | 'TJK' | 'TKL' | 'TKM' | 'TLS' | 'TON' | 'TTO' | 'TUN' | 'TUR' | 'TUV' | 'TWN' | 'TZA' | 'UGA' | 'UKR' | 'URY' | 'USA' | 'UZB' | 'VCT' | 'VEN' | 'VGB' | 'VIR' | 'VNM' | 'VUT' | 'WLF' | 'WSM' | 'XGZ' | 'XKS' | 'XPR' | 'XQZ' | 'XSP' | 'XSV' | 'XWB' | 'XXD' | 'YEM' | 'ZAF' | 'ZMB' | 'ZWE', iso-3166-alpha-3: The Country code in ISO 3166-1 alpha-3 format [[docs](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3)]. - `x-numUpcomingEvents` number: The number of upcoming events in this Country. \ Note: this is only provided in the Geography lookup endpoints, not as part of a location within a Concert, Festival, or Stream. - `x-streetAddress2` string: An optional second line for street address. - `x-timezone` string: A "tz database" timezone [[see list](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)]. - `x-jamBaseMetroId` number: A unique identifier to the JamBase metro. - `x-jamBaseCityId` number: A unique identifier to the JamBase city. - `geo` GeoCoordinates: The latitude and longitude for a place - `@type` 'GeoCoordinates' - `latitude` number, float: The latitude of a location - `longitude` number, float: The longitude of a location - `events` union[] - union - Concert: A generic thing - `name` string, required: The name of the item - `identifier` string, required: A unique identifier of the item - `url` string, uri, required: URL of the item - `image` string, uri: URL of an illustrative image, such as a press photo or logo. Most images are owned by third parties and JamBase grants no rights in them. Display by URL or from your own cache, refreshed when the URL changes. See https://data.jambase.com/api/docs/images. Please note that `image` may not be provided for all schemas that include `Thing` (for example `Organization`). - `sameAs` URL[]: URL of a reference Web page that unambiguously indicates the item's identity - … - `datePublished` string, iso-8601: The date the Event first appeared in ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that 'datePublished' may not be provided for all Schemas that include `Thing` (e.g. `Organization`) - `dateModified` string, iso-8601: The date the Event was last updated in ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that 'dateModified' may not be provided for all Schemas that include `Thing` (e.g. `Organization`). \ Indexing timestamps for Concert / Festival / Stream / MusicGroup / MusicVenue live on `datePublished` and `dateModified`. The sibling `x-createdOnDate` and `x-updatedOnDate` fields are scoped to data-source / `Organization` responses (e.g. ticket vendors, performance-rights organizations) and are not present on Event-derived schemas. - `eventStatus` 'scheduled' | 'postponed' | 'rescheduled' | 'cancelled', required: The scheduling status of a live event. This is separate from `deletionStatus`, which appears only on tombstone rows: - `scheduled` — expected to happen at the current `startDate`; show normally. - `postponed` — delayed with no confirmed replacement date yet; keep the row, label it postponed, and avoid promising the current date. - `rescheduled` — moved to a confirmed new date; keep the row, update the date, and use `previousStartDate` when present. - `cancelled` — will not take place as scheduled but remains a live catalog row; keep it for history and joins, then hide it or clearly label it in upcoming views. Always persist `eventStatus` on upsert. None of these values means the row was removed from the catalog. - `startDate` string, iso-8601, required: The start date and time of the item using ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that `startDate` is returned based on the venue's local time but without an offset. You can find the timezone at `event > location > address > x-timezone` if you need to do any conversions. - `endDate` string, iso-8601: The end date of the item using ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that `endDate` is returned based on the venue's local time but without an offset. You can find the timezone at `event > location > address > x-timezone` if you need to do any conversions. - `previousStartDate` string, iso-8601: For rescheduled events, the previously scheduled start date using ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that `previousStartDate` is returned based on the venue's local time but without an offset. You can find the timezone at `event > location > address > x-timezone` if you need to do any conversions. - `doorTime` string, iso-8601: The time admission will commence in local time using ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that `doorTime` is returned based on the venue's local time but without an offset. You can find the timezone at `event > location > address > x-timezone` if you need to do any conversions. - `location` MusicVenue, required (recursive) - `offers` Offer[] - … - `performer` object[], required - … - `eventAttendanceMode` 'mixed' | 'offline' | 'online': Indicates whether it occurs online, offline, or a mix. - `isAccessibleForFree` boolean - `x-promoImage` string, uri: A secondary promotional image for the event (e.g. admat) - `@type` 'Concert', required - `deletionStatus` 'deleted' | 'trashed' | 'merged': Present ONLY on tombstone rows returned by delta polls of currently sourced core feeds (requests that include `dateModifiedFrom`). This removal discriminator is separate from the live scheduling field `eventStatus`: - `deleted` — permanently removed; drop the cached row. - `trashed` — soft-deleted (events only; not an `eventStatus`). Treat the same as `deleted` and drop the cached row. - `merged` — folded into another record; repoint cached references to `mergedInto`. A tombstone row carries only `@type`, `identifier`, `deletionStatus`, `deletedAt`, `dateModified`, and (when `merged`) `mergedInto`. Tombstones count toward `perPage` and `pagination.totalItems` and are appended after live rows. For `deleted` / `trashed`, retention is 90 days from the visible-at `dateModified`; `merged` tombstones never expire. `deletedAt` is the true removal time and can be earlier than `dateModified` after a delayed backfill. Queries without `dateModifiedFrom` never return tombstones. Since 2026-10-29, delta queries filtered by artist or venue carry only matching tombstones: on events, `artistId` matches an artist in the removed event's lineup and `venueId` its venue, both as recorded when the event was removed (a `merged` event matches on the removed event, not the surviving one); on artists and venues, a merged record matches a filter on its own identifier. Their `pagination.totalItems` / `totalPages` count live rows plus the matching tombstones. Removals with no recorded artist or venue (mostly from before 2026-10-29) and deltas filtered by `artistSlug`, `artistName`, `venueSlug`, or `venueName` carry none. To see every removal, run one unfiltered `dateModifiedFrom` sweep (geo and date filters still carry all tombstones), or treat a `400 identifier_invalid` single-record lookup as removed. Current source coverage: events (`deleted`, `trashed`, `merged`), festivals (`deleted`), artists / venues / festival collections (`merged`), and no stream tombstones. - `deletedAt` string, iso-8601: The true upstream time when the record left the catalog, in ISO 8601. Present only on tombstone rows. This can be earlier than `dateModified` after a delayed backfill: `dateModified` is the later visible-at timestamp used for delta matching, ordering, and `deleted` / `trashed` retention. - `mergedInto` string: On a `merged` tombstone (see `deletionStatus`), the `identifier` of the surviving record this one was folded into. Repoint cached references from `identifier` to `mergedInto`. - `x-externalIdentifiers` unknown[] - … - `x-customTitle` string: To replace the default `event[name]` property - `x-subtitle` string: To supplement the title to help describe the event (e.g. Album Release Party) - `x-headlinerInSupport` boolean: if headlining performers should be listed with support acts (typically used with `x-customTitle`) - `x-streamIds` string[]: An array of one or more IDs for Streams associated with a Concert - Festival: A generic thing - `name` string, required: The name of the item - `identifier` string, required: A unique identifier of the item - `url` string, uri, required: URL of the item - `image` string, uri: URL of an illustrative image, such as a press photo or logo. Most images are owned by third parties and JamBase grants no rights in them. Display by URL or from your own cache, refreshed when the URL changes. See https://data.jambase.com/api/docs/images. Please note that `image` may not be provided for all schemas that include `Thing` (for example `Organization`). - `sameAs` URL[]: URL of a reference Web page that unambiguously indicates the item's identity - … - `datePublished` string, iso-8601: The date the Event first appeared in ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that 'datePublished' may not be provided for all Schemas that include `Thing` (e.g. `Organization`) - `dateModified` string, iso-8601: The date the Event was last updated in ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that 'dateModified' may not be provided for all Schemas that include `Thing` (e.g. `Organization`). \ Indexing timestamps for Concert / Festival / Stream / MusicGroup / MusicVenue live on `datePublished` and `dateModified`. The sibling `x-createdOnDate` and `x-updatedOnDate` fields are scoped to data-source / `Organization` responses (e.g. ticket vendors, performance-rights organizations) and are not present on Event-derived schemas. - `eventStatus` 'scheduled' | 'postponed' | 'rescheduled' | 'cancelled', required: The scheduling status of a live event. This is separate from `deletionStatus`, which appears only on tombstone rows: - `scheduled` — expected to happen at the current `startDate`; show normally. - `postponed` — delayed with no confirmed replacement date yet; keep the row, label it postponed, and avoid promising the current date. - `rescheduled` — moved to a confirmed new date; keep the row, update the date, and use `previousStartDate` when present. - `cancelled` — will not take place as scheduled but remains a live catalog row; keep it for history and joins, then hide it or clearly label it in upcoming views. Always persist `eventStatus` on upsert. None of these values means the row was removed from the catalog. - `startDate` string, iso-8601, required: The start date and time of the item using ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that `startDate` is returned based on the venue's local time but without an offset. You can find the timezone at `event > location > address > x-timezone` if you need to do any conversions. - `endDate` string, iso-8601, required: The end date of the item using ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that `endDate` is returned based on the venue's local time but without an offset. You can find the timezone at `event > location > address > x-timezone` if you need to do any conversions. - `previousStartDate` string, iso-8601: For rescheduled events, the previously scheduled start date using ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that `previousStartDate` is returned based on the venue's local time but without an offset. You can find the timezone at `event > location > address > x-timezone` if you need to do any conversions. - `doorTime` string, iso-8601: The time admission will commence in local time using ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that `doorTime` is returned based on the venue's local time but without an offset. You can find the timezone at `event > location > address > x-timezone` if you need to do any conversions. - `location` MusicVenue, required (recursive) - `offers` Offer[] - … - `performer` object[], required - … - `eventAttendanceMode` 'mixed' | 'offline' | 'online': Indicates whether it occurs online, offline, or a mix. - `isAccessibleForFree` boolean - `x-promoImage` string, uri: A secondary promotional image for the event (e.g. admat) - `@type` 'Festival', required - `deletionStatus` 'deleted' | 'trashed' | 'merged': Present ONLY on tombstone rows returned by delta polls of currently sourced core feeds (requests that include `dateModifiedFrom`). This removal discriminator is separate from the live scheduling field `eventStatus`: - `deleted` — permanently removed; drop the cached row. - `trashed` — soft-deleted (events only; not an `eventStatus`). Treat the same as `deleted` and drop the cached row. - `merged` — folded into another record; repoint cached references to `mergedInto`. A tombstone row carries only `@type`, `identifier`, `deletionStatus`, `deletedAt`, `dateModified`, and (when `merged`) `mergedInto`. Tombstones count toward `perPage` and `pagination.totalItems` and are appended after live rows. For `deleted` / `trashed`, retention is 90 days from the visible-at `dateModified`; `merged` tombstones never expire. `deletedAt` is the true removal time and can be earlier than `dateModified` after a delayed backfill. Queries without `dateModifiedFrom` never return tombstones. Since 2026-10-29, delta queries filtered by artist or venue carry only matching tombstones: on events, `artistId` matches an artist in the removed event's lineup and `venueId` its venue, both as recorded when the event was removed (a `merged` event matches on the removed event, not the surviving one); on artists and venues, a merged record matches a filter on its own identifier. Their `pagination.totalItems` / `totalPages` count live rows plus the matching tombstones. Removals with no recorded artist or venue (mostly from before 2026-10-29) and deltas filtered by `artistSlug`, `artistName`, `venueSlug`, or `venueName` carry none. To see every removal, run one unfiltered `dateModifiedFrom` sweep (geo and date filters still carry all tombstones), or treat a `400 identifier_invalid` single-record lookup as removed. Current source coverage: events (`deleted`, `trashed`, `merged`), festivals (`deleted`), artists / venues / festival collections (`merged`), and no stream tombstones. - `deletedAt` string, iso-8601: The true upstream time when the record left the catalog, in ISO 8601. Present only on tombstone rows. This can be earlier than `dateModified` after a delayed backfill: `dateModified` is the later visible-at timestamp used for delta matching, ordering, and `deleted` / `trashed` retention. - `mergedInto` string: On a `merged` tombstone (see `deletionStatus`), the `identifier` of the surviving record this one was folded into. Repoint cached references from `identifier` to `mergedInto`. - `x-lineupDisplayOption` 'full' | 'daybyday', required: Whether to display the `full` lineup or a `daybyday` breakdown - `x-isPermanentlyClosed` boolean: If the venue is permanently closed. - `x-numUpcomingEvents` number: The number of upcoming events at this venue. - `x-externalIdentifiers` unknown[] - unknown - `offers` Offer[] - `name` string: The name of the item - `identifier` string, required: A unique identifier of the item - `url` string, uri, required: URL of the item - `image` string, uri: URL of an illustrative image, such as a press photo or logo. Most images are owned by third parties and JamBase grants no rights in them. Display by URL or from your own cache, refreshed when the URL changes. See https://data.jambase.com/api/docs/images. Please note that `image` may not be provided for all schemas that include `Thing` (for example `Organization`). - `sameAs` URL[]: URL of a reference Web page that unambiguously indicates the item's identity - `@type` 'URL' - `identifier` 'officialSite' | 'facebook' | 'twitter' | 'instagram' | 'youtube' | 'musicbrainz' | 'spotify' | 'androidApp' | 'iosApp': The type of the external URL - `url` string, uri: The URL of the external link. - `datePublished` string, iso-8601: The date the Event first appeared in ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that 'datePublished' may not be provided for all Schemas that include `Thing` (e.g. `Organization`) - `dateModified` string, iso-8601: The date the Event was last updated in ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that 'dateModified' may not be provided for all Schemas that include `Thing` (e.g. `Organization`). \ Indexing timestamps for Concert / Festival / Stream / MusicGroup / MusicVenue live on `datePublished` and `dateModified`. The sibling `x-createdOnDate` and `x-updatedOnDate` fields are scoped to data-source / `Organization` responses (e.g. ticket vendors, performance-rights organizations) and are not present on Event-derived schemas. - `category` string, required: The category of the Offer, typically used to identify a primary or secondary ticketing link - `priceSpecification` PriceSpecification: The price or price range for the thing - `@type` 'PriceSpecification' - `minPrice` number: The lowest price if the price is a range - `maxPrice` number: The highest price if the price is a range - `price` number, required: The singular price if not a range, same as `minPrice` if a range - `priceCurrency` string, iso-4217, required: The currency of the price in ISO 4217 format [[docs](https://en.wikipedia.org/wiki/ISO_4217)] - `seller` Organization, required: A generic thing - `@type` 'Organization' - `identifier` string, required: A unique identifier of the item - `disambiguatingDescription` string, required - `name` string, required: The name of the item - `url` string, uri: URL of the item - `image` string, uri: URL of an illustrative image, such as a press photo or logo. Most images are owned by third parties and JamBase grants no rights in them. Display by URL or from your own cache, refreshed when the URL changes. See https://data.jambase.com/api/docs/images. Please note that `image` may not be provided for all schemas that include `Thing` (for example `Organization`). - `sameAs` URL[]: URL of a reference Web page that unambiguously indicates the item's identity - `@type` 'URL' - `identifier` 'officialSite' | 'facebook' | 'twitter' | 'instagram' | 'youtube' | 'musicbrainz' | 'spotify' | 'androidApp' | 'iosApp': The type of the external URL - `url` string, uri: The URL of the external link. - `datePublished` string, iso-8601, required: The date the Event first appeared in ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that 'datePublished' may not be provided for all Schemas that include `Thing` (e.g. `Organization`) - `dateModified` string, iso-8601, required: The date the Event was last updated in ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that 'dateModified' may not be provided for all Schemas that include `Thing` (e.g. `Organization`). \ Indexing timestamps for Concert / Festival / Stream / MusicGroup / MusicVenue live on `datePublished` and `dateModified`. The sibling `x-createdOnDate` and `x-updatedOnDate` fields are scoped to data-source / `Organization` responses (e.g. ticket vendors, performance-rights organizations) and are not present on Event-derived schemas. - `validFrom` string, required - `performer` object[], required - `name` string: The name of the item - `identifier` string: A unique identifier of the item - `url` string, uri: URL of the item - `image` string, uri: URL of an illustrative image, such as a press photo or logo. Most images are owned by third parties and JamBase grants no rights in them. Display by URL or from your own cache, refreshed when the URL changes. See https://data.jambase.com/api/docs/images. Please note that `image` may not be provided for all schemas that include `Thing` (for example `Organization`). - `sameAs` URL[]: URL of a reference Web page that unambiguously indicates the item's identity - `@type` 'URL' - `identifier` 'officialSite' | 'facebook' | 'twitter' | 'instagram' | 'youtube' | 'musicbrainz' | 'spotify' | 'androidApp' | 'iosApp': The type of the external URL - `url` string, uri: The URL of the external link. - `datePublished` string, iso-8601: The date the Event first appeared in ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that 'datePublished' may not be provided for all Schemas that include `Thing` (e.g. `Organization`) - `dateModified` string, iso-8601: The date the Event was last updated in ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that 'dateModified' may not be provided for all Schemas that include `Thing` (e.g. `Organization`). \ Indexing timestamps for Concert / Festival / Stream / MusicGroup / MusicVenue live on `datePublished` and `dateModified`. The sibling `x-createdOnDate` and `x-updatedOnDate` fields are scoped to data-source / `Organization` responses (e.g. ticket vendors, performance-rights organizations) and are not present on Event-derived schemas. - `@type` 'MusicGroup' - `deletionStatus` 'deleted' | 'trashed' | 'merged': Present ONLY on tombstone rows returned by delta polls of currently sourced core feeds (requests that include `dateModifiedFrom`). This removal discriminator is separate from the live scheduling field `eventStatus`: - `deleted` — permanently removed; drop the cached row. - `trashed` — soft-deleted (events only; not an `eventStatus`). Treat the same as `deleted` and drop the cached row. - `merged` — folded into another record; repoint cached references to `mergedInto`. A tombstone row carries only `@type`, `identifier`, `deletionStatus`, `deletedAt`, `dateModified`, and (when `merged`) `mergedInto`. Tombstones count toward `perPage` and `pagination.totalItems` and are appended after live rows. For `deleted` / `trashed`, retention is 90 days from the visible-at `dateModified`; `merged` tombstones never expire. `deletedAt` is the true removal time and can be earlier than `dateModified` after a delayed backfill. Queries without `dateModifiedFrom` never return tombstones. Since 2026-10-29, delta queries filtered by artist or venue carry only matching tombstones: on events, `artistId` matches an artist in the removed event's lineup and `venueId` its venue, both as recorded when the event was removed (a `merged` event matches on the removed event, not the surviving one); on artists and venues, a merged record matches a filter on its own identifier. Their `pagination.totalItems` / `totalPages` count live rows plus the matching tombstones. Removals with no recorded artist or venue (mostly from before 2026-10-29) and deltas filtered by `artistSlug`, `artistName`, `venueSlug`, or `venueName` carry none. To see every removal, run one unfiltered `dateModifiedFrom` sweep (geo and date filters still carry all tombstones), or treat a `400 identifier_invalid` single-record lookup as removed. Current source coverage: events (`deleted`, `trashed`, `merged`), festivals (`deleted`), artists / venues / festival collections (`merged`), and no stream tombstones. - `deletedAt` string, iso-8601: The true upstream time when the record left the catalog, in ISO 8601. Present only on tombstone rows. This can be earlier than `dateModified` after a delayed backfill: `dateModified` is the later visible-at timestamp used for delta matching, ordering, and `deleted` / `trashed` retention. - `mergedInto` string: On a `merged` tombstone (see `deletionStatus`), the `identifier` of the surviving record this one was folded into. Repoint cached references from `identifier` to `mergedInto`. - `member` object[]: For bands, an array of the band's members - `type` 'MusicGroup' - `name` string: The name of the item - `identifier` string: A unique identifier of the item - `image` string, uri: URL of an illustrative image, such as a press photo or logo. Most images are owned by third parties and JamBase grants no rights in them. Display by URL or from your own cache, refreshed when the URL changes. See https://data.jambase.com/api/docs/images. - `url` string, uri: URL of the item - `memberOf` object[]: For musicians, an array of the band's the musician is a member of - `@type` 'MusicGroup' - `name` string: The name of the item - `identifier` string: A unique identifier of the item - `image` string, uri: URL of an illustrative image, such as a press photo or logo. Most images are owned by third parties and JamBase grants no rights in them. Display by URL or from your own cache, refreshed when the URL changes. See https://data.jambase.com/api/docs/images. - `url` string, uri: URL of the item - `foundingLocation` object: The hometown of the artist - `@type` 'Place' - `name` string - `foundingDate` string, iso-8601: The year the artist first performed - `genre` EnumGenres[] - `events` union[]: Only available when using `expandUpcomingEvents=true` and/or `expandUpcomingStreams=true` URL param. - union - Concert: A generic thing - `name` string, required: The name of the item - `identifier` string, required: A unique identifier of the item - `url` string, uri, required: URL of the item - `image` string, uri: URL of an illustrative image, such as a press photo or logo. Most images are owned by third parties and JamBase grants no rights in them. Display by URL or from your own cache, refreshed when the URL changes. See https://data.jambase.com/api/docs/images. Please note that `image` may not be provided for all schemas that include `Thing` (for example `Organization`). - `sameAs` URL[]: URL of a reference Web page that unambiguously indicates the item's identity - … - `datePublished` string, iso-8601: The date the Event first appeared in ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that 'datePublished' may not be provided for all Schemas that include `Thing` (e.g. `Organization`) - `dateModified` string, iso-8601: The date the Event was last updated in ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that 'dateModified' may not be provided for all Schemas that include `Thing` (e.g. `Organization`). \ Indexing timestamps for Concert / Festival / Stream / MusicGroup / MusicVenue live on `datePublished` and `dateModified`. The sibling `x-createdOnDate` and `x-updatedOnDate` fields are scoped to data-source / `Organization` responses (e.g. ticket vendors, performance-rights organizations) and are not present on Event-derived schemas. - `eventStatus` 'scheduled' | 'postponed' | 'rescheduled' | 'cancelled', required: The scheduling status of a live event. This is separate from `deletionStatus`, which appears only on tombstone rows: - `scheduled` — expected to happen at the current `startDate`; show normally. - `postponed` — delayed with no confirmed replacement date yet; keep the row, label it postponed, and avoid promising the current date. - `rescheduled` — moved to a confirmed new date; keep the row, update the date, and use `previousStartDate` when present. - `cancelled` — will not take place as scheduled but remains a live catalog row; keep it for history and joins, then hide it or clearly label it in upcoming views. Always persist `eventStatus` on upsert. None of these values means the row was removed from the catalog. - `startDate` string, iso-8601, required: The start date and time of the item using ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that `startDate` is returned based on the venue's local time but without an offset. You can find the timezone at `event > location > address > x-timezone` if you need to do any conversions. - `endDate` string, iso-8601: The end date of the item using ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that `endDate` is returned based on the venue's local time but without an offset. You can find the timezone at `event > location > address > x-timezone` if you need to do any conversions. - `previousStartDate` string, iso-8601: For rescheduled events, the previously scheduled start date using ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that `previousStartDate` is returned based on the venue's local time but without an offset. You can find the timezone at `event > location > address > x-timezone` if you need to do any conversions. - `doorTime` string, iso-8601: The time admission will commence in local time using ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that `doorTime` is returned based on the venue's local time but without an offset. You can find the timezone at `event > location > address > x-timezone` if you need to do any conversions. - `location` MusicVenue, required: A generic thing - … - `offers` Offer[] - … - `performer` object[], required - … - `eventAttendanceMode` 'mixed' | 'offline' | 'online': Indicates whether it occurs online, offline, or a mix. - `isAccessibleForFree` boolean - `x-promoImage` string, uri: A secondary promotional image for the event (e.g. admat) - `@type` 'Concert', required - `deletionStatus` 'deleted' | 'trashed' | 'merged': Present ONLY on tombstone rows returned by delta polls of currently sourced core feeds (requests that include `dateModifiedFrom`). This removal discriminator is separate from the live scheduling field `eventStatus`: - `deleted` — permanently removed; drop the cached row. - `trashed` — soft-deleted (events only; not an `eventStatus`). Treat the same as `deleted` and drop the cached row. - `merged` — folded into another record; repoint cached references to `mergedInto`. A tombstone row carries only `@type`, `identifier`, `deletionStatus`, `deletedAt`, `dateModified`, and (when `merged`) `mergedInto`. Tombstones count toward `perPage` and `pagination.totalItems` and are appended after live rows. For `deleted` / `trashed`, retention is 90 days from the visible-at `dateModified`; `merged` tombstones never expire. `deletedAt` is the true removal time and can be earlier than `dateModified` after a delayed backfill. Queries without `dateModifiedFrom` never return tombstones. Since 2026-10-29, delta queries filtered by artist or venue carry only matching tombstones: on events, `artistId` matches an artist in the removed event's lineup and `venueId` its venue, both as recorded when the event was removed (a `merged` event matches on the removed event, not the surviving one); on artists and venues, a merged record matches a filter on its own identifier. Their `pagination.totalItems` / `totalPages` count live rows plus the matching tombstones. Removals with no recorded artist or venue (mostly from before 2026-10-29) and deltas filtered by `artistSlug`, `artistName`, `venueSlug`, or `venueName` carry none. To see every removal, run one unfiltered `dateModifiedFrom` sweep (geo and date filters still carry all tombstones), or treat a `400 identifier_invalid` single-record lookup as removed. Current source coverage: events (`deleted`, `trashed`, `merged`), festivals (`deleted`), artists / venues / festival collections (`merged`), and no stream tombstones. - `deletedAt` string, iso-8601: The true upstream time when the record left the catalog, in ISO 8601. Present only on tombstone rows. This can be earlier than `dateModified` after a delayed backfill: `dateModified` is the later visible-at timestamp used for delta matching, ordering, and `deleted` / `trashed` retention. - `mergedInto` string: On a `merged` tombstone (see `deletionStatus`), the `identifier` of the surviving record this one was folded into. Repoint cached references from `identifier` to `mergedInto`. - `x-externalIdentifiers` unknown[] - … - `x-customTitle` string: To replace the default `event[name]` property - `x-subtitle` string: To supplement the title to help describe the event (e.g. Album Release Party) - `x-headlinerInSupport` boolean: if headlining performers should be listed with support acts (typically used with `x-customTitle`) - `x-streamIds` string[]: An array of one or more IDs for Streams associated with a Concert - Festival: A generic thing - `name` string, required: The name of the item - `identifier` string, required: A unique identifier of the item - `url` string, uri, required: URL of the item - `image` string, uri: URL of an illustrative image, such as a press photo or logo. Most images are owned by third parties and JamBase grants no rights in them. Display by URL or from your own cache, refreshed when the URL changes. See https://data.jambase.com/api/docs/images. Please note that `image` may not be provided for all schemas that include `Thing` (for example `Organization`). - `sameAs` URL[]: URL of a reference Web page that unambiguously indicates the item's identity - … - `datePublished` string, iso-8601: The date the Event first appeared in ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that 'datePublished' may not be provided for all Schemas that include `Thing` (e.g. `Organization`) - `dateModified` string, iso-8601: The date the Event was last updated in ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that 'dateModified' may not be provided for all Schemas that include `Thing` (e.g. `Organization`). \ Indexing timestamps for Concert / Festival / Stream / MusicGroup / MusicVenue live on `datePublished` and `dateModified`. The sibling `x-createdOnDate` and `x-updatedOnDate` fields are scoped to data-source / `Organization` responses (e.g. ticket vendors, performance-rights organizations) and are not present on Event-derived schemas. - `eventStatus` 'scheduled' | 'postponed' | 'rescheduled' | 'cancelled', required: The scheduling status of a live event. This is separate from `deletionStatus`, which appears only on tombstone rows: - `scheduled` — expected to happen at the current `startDate`; show normally. - `postponed` — delayed with no confirmed replacement date yet; keep the row, label it postponed, and avoid promising the current date. - `rescheduled` — moved to a confirmed new date; keep the row, update the date, and use `previousStartDate` when present. - `cancelled` — will not take place as scheduled but remains a live catalog row; keep it for history and joins, then hide it or clearly label it in upcoming views. Always persist `eventStatus` on upsert. None of these values means the row was removed from the catalog. - `startDate` string, iso-8601, required: The start date and time of the item using ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that `startDate` is returned based on the venue's local time but without an offset. You can find the timezone at `event > location > address > x-timezone` if you need to do any conversions. - `endDate` string, iso-8601, required: The end date of the item using ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that `endDate` is returned based on the venue's local time but without an offset. You can find the timezone at `event > location > address > x-timezone` if you need to do any conversions. - `previousStartDate` string, iso-8601: For rescheduled events, the previously scheduled start date using ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that `previousStartDate` is returned based on the venue's local time but without an offset. You can find the timezone at `event > location > address > x-timezone` if you need to do any conversions. - `doorTime` string, iso-8601: The time admission will commence in local time using ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that `doorTime` is returned based on the venue's local time but without an offset. You can find the timezone at `event > location > address > x-timezone` if you need to do any conversions. - `location` MusicVenue, required: A generic thing - … - `offers` Offer[] - … - `performer` object[], required - … - `eventAttendanceMode` 'mixed' | 'offline' | 'online': Indicates whether it occurs online, offline, or a mix. - `isAccessibleForFree` boolean - `x-promoImage` string, uri: A secondary promotional image for the event (e.g. admat) - `@type` 'Festival', required - `deletionStatus` 'deleted' | 'trashed' | 'merged': Present ONLY on tombstone rows returned by delta polls of currently sourced core feeds (requests that include `dateModifiedFrom`). This removal discriminator is separate from the live scheduling field `eventStatus`: - `deleted` — permanently removed; drop the cached row. - `trashed` — soft-deleted (events only; not an `eventStatus`). Treat the same as `deleted` and drop the cached row. - `merged` — folded into another record; repoint cached references to `mergedInto`. A tombstone row carries only `@type`, `identifier`, `deletionStatus`, `deletedAt`, `dateModified`, and (when `merged`) `mergedInto`. Tombstones count toward `perPage` and `pagination.totalItems` and are appended after live rows. For `deleted` / `trashed`, retention is 90 days from the visible-at `dateModified`; `merged` tombstones never expire. `deletedAt` is the true removal time and can be earlier than `dateModified` after a delayed backfill. Queries without `dateModifiedFrom` never return tombstones. Since 2026-10-29, delta queries filtered by artist or venue carry only matching tombstones: on events, `artistId` matches an artist in the removed event's lineup and `venueId` its venue, both as recorded when the event was removed (a `merged` event matches on the removed event, not the surviving one); on artists and venues, a merged record matches a filter on its own identifier. Their `pagination.totalItems` / `totalPages` count live rows plus the matching tombstones. Removals with no recorded artist or venue (mostly from before 2026-10-29) and deltas filtered by `artistSlug`, `artistName`, `venueSlug`, or `venueName` carry none. To see every removal, run one unfiltered `dateModifiedFrom` sweep (geo and date filters still carry all tombstones), or treat a `400 identifier_invalid` single-record lookup as removed. Current source coverage: events (`deleted`, `trashed`, `merged`), festivals (`deleted`), artists / venues / festival collections (`merged`), and no stream tombstones. - `deletedAt` string, iso-8601: The true upstream time when the record left the catalog, in ISO 8601. Present only on tombstone rows. This can be earlier than `dateModified` after a delayed backfill: `dateModified` is the later visible-at timestamp used for delta matching, ordering, and `deleted` / `trashed` retention. - `mergedInto` string: On a `merged` tombstone (see `deletionStatus`), the `identifier` of the surviving record this one was folded into. Repoint cached references from `identifier` to `mergedInto`. - `x-lineupDisplayOption` 'full' | 'daybyday', required: Whether to display the `full` lineup or a `daybyday` breakdown - Stream (recursive) - `x-bandOrMusician` 'band' | 'musician' - `x-numUpcomingEvents` number: The number of upcoming events for this artist. - `x-externalIdentifiers` unknown[] - unknown - `x-performanceDate` string, iso-8601: The date of the performance using ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] - `x-performanceRank` number: The "rank" for this performance whithin the event - `x-isHeadliner` boolean: If this performer is a headliner - `x-dateIsConfirmed` boolean: Required for Festivals. If a Festival performance date is confirmed or not.\ If not, it will appear on the first day of the Festival. - `eventAttendanceMode` 'mixed' | 'offline' | 'online': Indicates whether it occurs online, offline, or a mix. - `isAccessibleForFree` boolean - `x-promoImage` string, uri: A secondary promotional image for the event (e.g. admat) - `@type` 'Stream', required - `deletionStatus` 'deleted' | 'trashed' | 'merged': Present ONLY on tombstone rows returned by delta polls of currently sourced core feeds (requests that include `dateModifiedFrom`). This removal discriminator is separate from the live scheduling field `eventStatus`: - `deleted` — permanently removed; drop the cached row. - `trashed` — soft-deleted (events only; not an `eventStatus`). Treat the same as `deleted` and drop the cached row. - `merged` — folded into another record; repoint cached references to `mergedInto`. A tombstone row carries only `@type`, `identifier`, `deletionStatus`, `deletedAt`, `dateModified`, and (when `merged`) `mergedInto`. Tombstones count toward `perPage` and `pagination.totalItems` and are appended after live rows. For `deleted` / `trashed`, retention is 90 days from the visible-at `dateModified`; `merged` tombstones never expire. `deletedAt` is the true removal time and can be earlier than `dateModified` after a delayed backfill. Queries without `dateModifiedFrom` never return tombstones. Since 2026-10-29, delta queries filtered by artist or venue carry only matching tombstones: on events, `artistId` matches an artist in the removed event's lineup and `venueId` its venue, both as recorded when the event was removed (a `merged` event matches on the removed event, not the surviving one); on artists and venues, a merged record matches a filter on its own identifier. Their `pagination.totalItems` / `totalPages` count live rows plus the matching tombstones. Removals with no recorded artist or venue (mostly from before 2026-10-29) and deltas filtered by `artistSlug`, `artistName`, `venueSlug`, or `venueName` carry none. To see every removal, run one unfiltered `dateModifiedFrom` sweep (geo and date filters still carry all tombstones), or treat a `400 identifier_invalid` single-record lookup as removed. Current source coverage: events (`deleted`, `trashed`, `merged`), festivals (`deleted`), artists / venues / festival collections (`merged`), and no stream tombstones. - `deletedAt` string, iso-8601: The true upstream time when the record left the catalog, in ISO 8601. Present only on tombstone rows. This can be earlier than `dateModified` after a delayed backfill: `dateModified` is the later visible-at timestamp used for delta matching, ordering, and `deleted` / `trashed` retention. - `mergedInto` string: On a `merged` tombstone (see `deletionStatus`), the `identifier` of the surviving record this one was folded into. Repoint cached references from `identifier` to `mergedInto`. - `isLiveBroadcast` boolean: True if the broadcast is of a live event - `broadcastOfEvent` union[] - union - Concert: A generic thing - `name` string, required: The name of the item - `identifier` string, required: A unique identifier of the item - `url` string, uri, required: URL of the item - `image` string, uri: URL of an illustrative image, such as a press photo or logo. Most images are owned by third parties and JamBase grants no rights in them. Display by URL or from your own cache, refreshed when the URL changes. See https://data.jambase.com/api/docs/images. Please note that `image` may not be provided for all schemas that include `Thing` (for example `Organization`). - `sameAs` URL[]: URL of a reference Web page that unambiguously indicates the item's identity - `@type` 'URL' - `identifier` 'officialSite' | 'facebook' | 'twitter' | 'instagram' | 'youtube' | 'musicbrainz' | 'spotify' | 'androidApp' | 'iosApp': The type of the external URL - `url` string, uri: The URL of the external link. - `datePublished` string, iso-8601: The date the Event first appeared in ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that 'datePublished' may not be provided for all Schemas that include `Thing` (e.g. `Organization`) - `dateModified` string, iso-8601: The date the Event was last updated in ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that 'dateModified' may not be provided for all Schemas that include `Thing` (e.g. `Organization`). \ Indexing timestamps for Concert / Festival / Stream / MusicGroup / MusicVenue live on `datePublished` and `dateModified`. The sibling `x-createdOnDate` and `x-updatedOnDate` fields are scoped to data-source / `Organization` responses (e.g. ticket vendors, performance-rights organizations) and are not present on Event-derived schemas. - `eventStatus` 'scheduled' | 'postponed' | 'rescheduled' | 'cancelled', required: The scheduling status of a live event. This is separate from `deletionStatus`, which appears only on tombstone rows: - `scheduled` — expected to happen at the current `startDate`; show normally. - `postponed` — delayed with no confirmed replacement date yet; keep the row, label it postponed, and avoid promising the current date. - `rescheduled` — moved to a confirmed new date; keep the row, update the date, and use `previousStartDate` when present. - `cancelled` — will not take place as scheduled but remains a live catalog row; keep it for history and joins, then hide it or clearly label it in upcoming views. Always persist `eventStatus` on upsert. None of these values means the row was removed from the catalog. - `startDate` string, iso-8601, required: The start date and time of the item using ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that `startDate` is returned based on the venue's local time but without an offset. You can find the timezone at `event > location > address > x-timezone` if you need to do any conversions. - `endDate` string, iso-8601: The end date of the item using ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that `endDate` is returned based on the venue's local time but without an offset. You can find the timezone at `event > location > address > x-timezone` if you need to do any conversions. - `previousStartDate` string, iso-8601: For rescheduled events, the previously scheduled start date using ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that `previousStartDate` is returned based on the venue's local time but without an offset. You can find the timezone at `event > location > address > x-timezone` if you need to do any conversions. - `doorTime` string, iso-8601: The time admission will commence in local time using ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that `doorTime` is returned based on the venue's local time but without an offset. You can find the timezone at `event > location > address > x-timezone` if you need to do any conversions. - `location` MusicVenue, required: A generic thing - `name` string: The name of the item - `identifier` string: A unique identifier of the item - `url` string, uri: URL of the item - `image` string, uri: URL of an illustrative image, such as a press photo or logo. Most images are owned by third parties and JamBase grants no rights in them. Display by URL or from your own cache, refreshed when the URL changes. See https://data.jambase.com/api/docs/images. Please note that `image` may not be provided for all schemas that include `Thing` (for example `Organization`). - `sameAs` URL[]: URL of a reference Web page that unambiguously indicates the item's identity - … - `datePublished` string, iso-8601: The date the Event first appeared in ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that 'datePublished' may not be provided for all Schemas that include `Thing` (e.g. `Organization`) - `dateModified` string, iso-8601: The date the Event was last updated in ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that 'dateModified' may not be provided for all Schemas that include `Thing` (e.g. `Organization`). \ Indexing timestamps for Concert / Festival / Stream / MusicGroup / MusicVenue live on `datePublished` and `dateModified`. The sibling `x-createdOnDate` and `x-updatedOnDate` fields are scoped to data-source / `Organization` responses (e.g. ticket vendors, performance-rights organizations) and are not present on Event-derived schemas. - `deletionStatus` 'deleted' | 'trashed' | 'merged': Present ONLY on tombstone rows returned by delta polls of currently sourced core feeds (requests that include `dateModifiedFrom`). This removal discriminator is separate from the live scheduling field `eventStatus`: - `deleted` — permanently removed; drop the cached row. - `trashed` — soft-deleted (events only; not an `eventStatus`). Treat the same as `deleted` and drop the cached row. - `merged` — folded into another record; repoint cached references to `mergedInto`. A tombstone row carries only `@type`, `identifier`, `deletionStatus`, `deletedAt`, `dateModified`, and (when `merged`) `mergedInto`. Tombstones count toward `perPage` and `pagination.totalItems` and are appended after live rows. For `deleted` / `trashed`, retention is 90 days from the visible-at `dateModified`; `merged` tombstones never expire. `deletedAt` is the true removal time and can be earlier than `dateModified` after a delayed backfill. Queries without `dateModifiedFrom` never return tombstones. Since 2026-10-29, delta queries filtered by artist or venue carry only matching tombstones: on events, `artistId` matches an artist in the removed event's lineup and `venueId` its venue, both as recorded when the event was removed (a `merged` event matches on the removed event, not the surviving one); on artists and venues, a merged record matches a filter on its own identifier. Their `pagination.totalItems` / `totalPages` count live rows plus the matching tombstones. Removals with no recorded artist or venue (mostly from before 2026-10-29) and deltas filtered by `artistSlug`, `artistName`, `venueSlug`, or `venueName` carry none. To see every removal, run one unfiltered `dateModifiedFrom` sweep (geo and date filters still carry all tombstones), or treat a `400 identifier_invalid` single-record lookup as removed. Current source coverage: events (`deleted`, `trashed`, `merged`), festivals (`deleted`), artists / venues / festival collections (`merged`), and no stream tombstones. - `deletedAt` string, iso-8601: The true upstream time when the record left the catalog, in ISO 8601. Present only on tombstone rows. This can be earlier than `dateModified` after a delayed backfill: `dateModified` is the later visible-at timestamp used for delta matching, ordering, and `deleted` / `trashed` retention. - `mergedInto` string: On a `merged` tombstone (see `deletionStatus`), the `identifier` of the surviving record this one was folded into. Repoint cached references from `identifier` to `mergedInto`. - `maximumAttendeeCapacity` number: The total number of individuals that may attend an event or venue. - `address` PostalAddress: A postal address, typically for a MusicVenue - … - `geo` GeoCoordinates: The latitude and longitude for a place - … - `events` union[] - … - `x-isPermanentlyClosed` boolean: If the venue is permanently closed. - `x-numUpcomingEvents` number: The number of upcoming events at this venue. - `x-externalIdentifiers` unknown[] - … - `offers` Offer[] - `name` string: The name of the item - `identifier` string, required: A unique identifier of the item - `url` string, uri, required: URL of the item - `image` string, uri: URL of an illustrative image, such as a press photo or logo. Most images are owned by third parties and JamBase grants no rights in them. Display by URL or from your own cache, refreshed when the URL changes. See https://data.jambase.com/api/docs/images. Please note that `image` may not be provided for all schemas that include `Thing` (for example `Organization`). - `sameAs` URL[]: URL of a reference Web page that unambiguously indicates the item's identity - … - `datePublished` string, iso-8601: The date the Event first appeared in ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that 'datePublished' may not be provided for all Schemas that include `Thing` (e.g. `Organization`) - `dateModified` string, iso-8601: The date the Event was last updated in ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that 'dateModified' may not be provided for all Schemas that include `Thing` (e.g. `Organization`). \ Indexing timestamps for Concert / Festival / Stream / MusicGroup / MusicVenue live on `datePublished` and `dateModified`. The sibling `x-createdOnDate` and `x-updatedOnDate` fields are scoped to data-source / `Organization` responses (e.g. ticket vendors, performance-rights organizations) and are not present on Event-derived schemas. - `category` string, required: The category of the Offer, typically used to identify a primary or secondary ticketing link - `priceSpecification` PriceSpecification: The price or price range for the thing - … - `seller` Organization, required: A generic thing - … - `validFrom` string, required - `performer` object[], required - `name` string: The name of the item - `identifier` string: A unique identifier of the item - `url` string, uri: URL of the item - `image` string, uri: URL of an illustrative image, such as a press photo or logo. Most images are owned by third parties and JamBase grants no rights in them. Display by URL or from your own cache, refreshed when the URL changes. See https://data.jambase.com/api/docs/images. Please note that `image` may not be provided for all schemas that include `Thing` (for example `Organization`). - `sameAs` URL[]: URL of a reference Web page that unambiguously indicates the item's identity - … - `datePublished` string, iso-8601: The date the Event first appeared in ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that 'datePublished' may not be provided for all Schemas that include `Thing` (e.g. `Organization`) - `dateModified` string, iso-8601: The date the Event was last updated in ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that 'dateModified' may not be provided for all Schemas that include `Thing` (e.g. `Organization`). \ Indexing timestamps for Concert / Festival / Stream / MusicGroup / MusicVenue live on `datePublished` and `dateModified`. The sibling `x-createdOnDate` and `x-updatedOnDate` fields are scoped to data-source / `Organization` responses (e.g. ticket vendors, performance-rights organizations) and are not present on Event-derived schemas. - `@type` 'MusicGroup' - `deletionStatus` 'deleted' | 'trashed' | 'merged': Present ONLY on tombstone rows returned by delta polls of currently sourced core feeds (requests that include `dateModifiedFrom`). This removal discriminator is separate from the live scheduling field `eventStatus`: - `deleted` — permanently removed; drop the cached row. - `trashed` — soft-deleted (events only; not an `eventStatus`). Treat the same as `deleted` and drop the cached row. - `merged` — folded into another record; repoint cached references to `mergedInto`. A tombstone row carries only `@type`, `identifier`, `deletionStatus`, `deletedAt`, `dateModified`, and (when `merged`) `mergedInto`. Tombstones count toward `perPage` and `pagination.totalItems` and are appended after live rows. For `deleted` / `trashed`, retention is 90 days from the visible-at `dateModified`; `merged` tombstones never expire. `deletedAt` is the true removal time and can be earlier than `dateModified` after a delayed backfill. Queries without `dateModifiedFrom` never return tombstones. Since 2026-10-29, delta queries filtered by artist or venue carry only matching tombstones: on events, `artistId` matches an artist in the removed event's lineup and `venueId` its venue, both as recorded when the event was removed (a `merged` event matches on the removed event, not the surviving one); on artists and venues, a merged record matches a filter on its own identifier. Their `pagination.totalItems` / `totalPages` count live rows plus the matching tombstones. Removals with no recorded artist or venue (mostly from before 2026-10-29) and deltas filtered by `artistSlug`, `artistName`, `venueSlug`, or `venueName` carry none. To see every removal, run one unfiltered `dateModifiedFrom` sweep (geo and date filters still carry all tombstones), or treat a `400 identifier_invalid` single-record lookup as removed. Current source coverage: events (`deleted`, `trashed`, `merged`), festivals (`deleted`), artists / venues / festival collections (`merged`), and no stream tombstones. - `deletedAt` string, iso-8601: The true upstream time when the record left the catalog, in ISO 8601. Present only on tombstone rows. This can be earlier than `dateModified` after a delayed backfill: `dateModified` is the later visible-at timestamp used for delta matching, ordering, and `deleted` / `trashed` retention. - `mergedInto` string: On a `merged` tombstone (see `deletionStatus`), the `identifier` of the surviving record this one was folded into. Repoint cached references from `identifier` to `mergedInto`. - `member` object[]: For bands, an array of the band's members - … - `memberOf` object[]: For musicians, an array of the band's the musician is a member of - … - `foundingLocation` object: The hometown of the artist - … - `foundingDate` string, iso-8601: The year the artist first performed - `genre` EnumGenres[] - `events` union[]: Only available when using `expandUpcomingEvents=true` and/or `expandUpcomingStreams=true` URL param. - … - `x-bandOrMusician` 'band' | 'musician' - `x-numUpcomingEvents` number: The number of upcoming events for this artist. - `x-externalIdentifiers` unknown[] - … - `x-performanceDate` string, iso-8601: The date of the performance using ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] - `x-performanceRank` number: The "rank" for this performance whithin the event - `x-isHeadliner` boolean: If this performer is a headliner - `x-dateIsConfirmed` boolean: Required for Festivals. If a Festival performance date is confirmed or not.\ If not, it will appear on the first day of the Festival. - `eventAttendanceMode` 'mixed' | 'offline' | 'online': Indicates whether it occurs online, offline, or a mix. - `isAccessibleForFree` boolean - `x-promoImage` string, uri: A secondary promotional image for the event (e.g. admat) - `@type` 'Concert', required - `deletionStatus` 'deleted' | 'trashed' | 'merged': Present ONLY on tombstone rows returned by delta polls of currently sourced core feeds (requests that include `dateModifiedFrom`). This removal discriminator is separate from the live scheduling field `eventStatus`: - `deleted` — permanently removed; drop the cached row. - `trashed` — soft-deleted (events only; not an `eventStatus`). Treat the same as `deleted` and drop the cached row. - `merged` — folded into another record; repoint cached references to `mergedInto`. A tombstone row carries only `@type`, `identifier`, `deletionStatus`, `deletedAt`, `dateModified`, and (when `merged`) `mergedInto`. Tombstones count toward `perPage` and `pagination.totalItems` and are appended after live rows. For `deleted` / `trashed`, retention is 90 days from the visible-at `dateModified`; `merged` tombstones never expire. `deletedAt` is the true removal time and can be earlier than `dateModified` after a delayed backfill. Queries without `dateModifiedFrom` never return tombstones. Since 2026-10-29, delta queries filtered by artist or venue carry only matching tombstones: on events, `artistId` matches an artist in the removed event's lineup and `venueId` its venue, both as recorded when the event was removed (a `merged` event matches on the removed event, not the surviving one); on artists and venues, a merged record matches a filter on its own identifier. Their `pagination.totalItems` / `totalPages` count live rows plus the matching tombstones. Removals with no recorded artist or venue (mostly from before 2026-10-29) and deltas filtered by `artistSlug`, `artistName`, `venueSlug`, or `venueName` carry none. To see every removal, run one unfiltered `dateModifiedFrom` sweep (geo and date filters still carry all tombstones), or treat a `400 identifier_invalid` single-record lookup as removed. Current source coverage: events (`deleted`, `trashed`, `merged`), festivals (`deleted`), artists / venues / festival collections (`merged`), and no stream tombstones. - `deletedAt` string, iso-8601: The true upstream time when the record left the catalog, in ISO 8601. Present only on tombstone rows. This can be earlier than `dateModified` after a delayed backfill: `dateModified` is the later visible-at timestamp used for delta matching, ordering, and `deleted` / `trashed` retention. - `mergedInto` string: On a `merged` tombstone (see `deletionStatus`), the `identifier` of the surviving record this one was folded into. Repoint cached references from `identifier` to `mergedInto`. - `x-externalIdentifiers` unknown[] - unknown - `x-customTitle` string: To replace the default `event[name]` property - `x-subtitle` string: To supplement the title to help describe the event (e.g. Album Release Party) - `x-headlinerInSupport` boolean: if headlining performers should be listed with support acts (typically used with `x-customTitle`) - `x-streamIds` string[]: An array of one or more IDs for Streams associated with a Concert - Festival: A generic thing - `name` string, required: The name of the item - `identifier` string, required: A unique identifier of the item - `url` string, uri, required: URL of the item - `image` string, uri: URL of an illustrative image, such as a press photo or logo. Most images are owned by third parties and JamBase grants no rights in them. Display by URL or from your own cache, refreshed when the URL changes. See https://data.jambase.com/api/docs/images. Please note that `image` may not be provided for all schemas that include `Thing` (for example `Organization`). - `sameAs` URL[]: URL of a reference Web page that unambiguously indicates the item's identity - `@type` 'URL' - `identifier` 'officialSite' | 'facebook' | 'twitter' | 'instagram' | 'youtube' | 'musicbrainz' | 'spotify' | 'androidApp' | 'iosApp': The type of the external URL - `url` string, uri: The URL of the external link. - `datePublished` string, iso-8601: The date the Event first appeared in ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that 'datePublished' may not be provided for all Schemas that include `Thing` (e.g. `Organization`) - `dateModified` string, iso-8601: The date the Event was last updated in ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that 'dateModified' may not be provided for all Schemas that include `Thing` (e.g. `Organization`). \ Indexing timestamps for Concert / Festival / Stream / MusicGroup / MusicVenue live on `datePublished` and `dateModified`. The sibling `x-createdOnDate` and `x-updatedOnDate` fields are scoped to data-source / `Organization` responses (e.g. ticket vendors, performance-rights organizations) and are not present on Event-derived schemas. - `eventStatus` 'scheduled' | 'postponed' | 'rescheduled' | 'cancelled', required: The scheduling status of a live event. This is separate from `deletionStatus`, which appears only on tombstone rows: - `scheduled` — expected to happen at the current `startDate`; show normally. - `postponed` — delayed with no confirmed replacement date yet; keep the row, label it postponed, and avoid promising the current date. - `rescheduled` — moved to a confirmed new date; keep the row, update the date, and use `previousStartDate` when present. - `cancelled` — will not take place as scheduled but remains a live catalog row; keep it for history and joins, then hide it or clearly label it in upcoming views. Always persist `eventStatus` on upsert. None of these values means the row was removed from the catalog. - `startDate` string, iso-8601, required: The start date and time of the item using ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that `startDate` is returned based on the venue's local time but without an offset. You can find the timezone at `event > location > address > x-timezone` if you need to do any conversions. - `endDate` string, iso-8601, required: The end date of the item using ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that `endDate` is returned based on the venue's local time but without an offset. You can find the timezone at `event > location > address > x-timezone` if you need to do any conversions. - `previousStartDate` string, iso-8601: For rescheduled events, the previously scheduled start date using ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that `previousStartDate` is returned based on the venue's local time but without an offset. You can find the timezone at `event > location > address > x-timezone` if you need to do any conversions. - `doorTime` string, iso-8601: The time admission will commence in local time using ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that `doorTime` is returned based on the venue's local time but without an offset. You can find the timezone at `event > location > address > x-timezone` if you need to do any conversions. - `location` MusicVenue, required: A generic thing - `name` string: The name of the item - `identifier` string: A unique identifier of the item - `url` string, uri: URL of the item - `image` string, uri: URL of an illustrative image, such as a press photo or logo. Most images are owned by third parties and JamBase grants no rights in them. Display by URL or from your own cache, refreshed when the URL changes. See https://data.jambase.com/api/docs/images. Please note that `image` may not be provided for all schemas that include `Thing` (for example `Organization`). - `sameAs` URL[]: URL of a reference Web page that unambiguously indicates the item's identity - … - `datePublished` string, iso-8601: The date the Event first appeared in ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that 'datePublished' may not be provided for all Schemas that include `Thing` (e.g. `Organization`) - `dateModified` string, iso-8601: The date the Event was last updated in ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that 'dateModified' may not be provided for all Schemas that include `Thing` (e.g. `Organization`). \ Indexing timestamps for Concert / Festival / Stream / MusicGroup / MusicVenue live on `datePublished` and `dateModified`. The sibling `x-createdOnDate` and `x-updatedOnDate` fields are scoped to data-source / `Organization` responses (e.g. ticket vendors, performance-rights organizations) and are not present on Event-derived schemas. - `deletionStatus` 'deleted' | 'trashed' | 'merged': Present ONLY on tombstone rows returned by delta polls of currently sourced core feeds (requests that include `dateModifiedFrom`). This removal discriminator is separate from the live scheduling field `eventStatus`: - `deleted` — permanently removed; drop the cached row. - `trashed` — soft-deleted (events only; not an `eventStatus`). Treat the same as `deleted` and drop the cached row. - `merged` — folded into another record; repoint cached references to `mergedInto`. A tombstone row carries only `@type`, `identifier`, `deletionStatus`, `deletedAt`, `dateModified`, and (when `merged`) `mergedInto`. Tombstones count toward `perPage` and `pagination.totalItems` and are appended after live rows. For `deleted` / `trashed`, retention is 90 days from the visible-at `dateModified`; `merged` tombstones never expire. `deletedAt` is the true removal time and can be earlier than `dateModified` after a delayed backfill. Queries without `dateModifiedFrom` never return tombstones. Since 2026-10-29, delta queries filtered by artist or venue carry only matching tombstones: on events, `artistId` matches an artist in the removed event's lineup and `venueId` its venue, both as recorded when the event was removed (a `merged` event matches on the removed event, not the surviving one); on artists and venues, a merged record matches a filter on its own identifier. Their `pagination.totalItems` / `totalPages` count live rows plus the matching tombstones. Removals with no recorded artist or venue (mostly from before 2026-10-29) and deltas filtered by `artistSlug`, `artistName`, `venueSlug`, or `venueName` carry none. To see every removal, run one unfiltered `dateModifiedFrom` sweep (geo and date filters still carry all tombstones), or treat a `400 identifier_invalid` single-record lookup as removed. Current source coverage: events (`deleted`, `trashed`, `merged`), festivals (`deleted`), artists / venues / festival collections (`merged`), and no stream tombstones. - `deletedAt` string, iso-8601: The true upstream time when the record left the catalog, in ISO 8601. Present only on tombstone rows. This can be earlier than `dateModified` after a delayed backfill: `dateModified` is the later visible-at timestamp used for delta matching, ordering, and `deleted` / `trashed` retention. - `mergedInto` string: On a `merged` tombstone (see `deletionStatus`), the `identifier` of the surviving record this one was folded into. Repoint cached references from `identifier` to `mergedInto`. - `maximumAttendeeCapacity` number: The total number of individuals that may attend an event or venue. - `address` PostalAddress: A postal address, typically for a MusicVenue - … - `geo` GeoCoordinates: The latitude and longitude for a place - … - `events` union[] - … - `x-isPermanentlyClosed` boolean: If the venue is permanently closed. - `x-numUpcomingEvents` number: The number of upcoming events at this venue. - `x-externalIdentifiers` unknown[] - … - `offers` Offer[] - `name` string: The name of the item - `identifier` string, required: A unique identifier of the item - `url` string, uri, required: URL of the item - `image` string, uri: URL of an illustrative image, such as a press photo or logo. Most images are owned by third parties and JamBase grants no rights in them. Display by URL or from your own cache, refreshed when the URL changes. See https://data.jambase.com/api/docs/images. Please note that `image` may not be provided for all schemas that include `Thing` (for example `Organization`). - `sameAs` URL[]: URL of a reference Web page that unambiguously indicates the item's identity - … - `datePublished` string, iso-8601: The date the Event first appeared in ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that 'datePublished' may not be provided for all Schemas that include `Thing` (e.g. `Organization`) - `dateModified` string, iso-8601: The date the Event was last updated in ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that 'dateModified' may not be provided for all Schemas that include `Thing` (e.g. `Organization`). \ Indexing timestamps for Concert / Festival / Stream / MusicGroup / MusicVenue live on `datePublished` and `dateModified`. The sibling `x-createdOnDate` and `x-updatedOnDate` fields are scoped to data-source / `Organization` responses (e.g. ticket vendors, performance-rights organizations) and are not present on Event-derived schemas. - `category` string, required: The category of the Offer, typically used to identify a primary or secondary ticketing link - `priceSpecification` PriceSpecification: The price or price range for the thing - … - `seller` Organization, required: A generic thing - … - `validFrom` string, required - `performer` object[], required - `name` string: The name of the item - `identifier` string: A unique identifier of the item - `url` string, uri: URL of the item - `image` string, uri: URL of an illustrative image, such as a press photo or logo. Most images are owned by third parties and JamBase grants no rights in them. Display by URL or from your own cache, refreshed when the URL changes. See https://data.jambase.com/api/docs/images. Please note that `image` may not be provided for all schemas that include `Thing` (for example `Organization`). - `sameAs` URL[]: URL of a reference Web page that unambiguously indicates the item's identity - … - `datePublished` string, iso-8601: The date the Event first appeared in ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that 'datePublished' may not be provided for all Schemas that include `Thing` (e.g. `Organization`) - `dateModified` string, iso-8601: The date the Event was last updated in ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] \ Please note that 'dateModified' may not be provided for all Schemas that include `Thing` (e.g. `Organization`). \ Indexing timestamps for Concert / Festival / Stream / MusicGroup / MusicVenue live on `datePublished` and `dateModified`. The sibling `x-createdOnDate` and `x-updatedOnDate` fields are scoped to data-source / `Organization` responses (e.g. ticket vendors, performance-rights organizations) and are not present on Event-derived schemas. - `@type` 'MusicGroup' - `deletionStatus` 'deleted' | 'trashed' | 'merged': Present ONLY on tombstone rows returned by delta polls of currently sourced core feeds (requests that include `dateModifiedFrom`). This removal discriminator is separate from the live scheduling field `eventStatus`: - `deleted` — permanently removed; drop the cached row. - `trashed` — soft-deleted (events only; not an `eventStatus`). Treat the same as `deleted` and drop the cached row. - `merged` — folded into another record; repoint cached references to `mergedInto`. A tombstone row carries only `@type`, `identifier`, `deletionStatus`, `deletedAt`, `dateModified`, and (when `merged`) `mergedInto`. Tombstones count toward `perPage` and `pagination.totalItems` and are appended after live rows. For `deleted` / `trashed`, retention is 90 days from the visible-at `dateModified`; `merged` tombstones never expire. `deletedAt` is the true removal time and can be earlier than `dateModified` after a delayed backfill. Queries without `dateModifiedFrom` never return tombstones. Since 2026-10-29, delta queries filtered by artist or venue carry only matching tombstones: on events, `artistId` matches an artist in the removed event's lineup and `venueId` its venue, both as recorded when the event was removed (a `merged` event matches on the removed event, not the surviving one); on artists and venues, a merged record matches a filter on its own identifier. Their `pagination.totalItems` / `totalPages` count live rows plus the matching tombstones. Removals with no recorded artist or venue (mostly from before 2026-10-29) and deltas filtered by `artistSlug`, `artistName`, `venueSlug`, or `venueName` carry none. To see every removal, run one unfiltered `dateModifiedFrom` sweep (geo and date filters still carry all tombstones), or treat a `400 identifier_invalid` single-record lookup as removed. Current source coverage: events (`deleted`, `trashed`, `merged`), festivals (`deleted`), artists / venues / festival collections (`merged`), and no stream tombstones. - `deletedAt` string, iso-8601: The true upstream time when the record left the catalog, in ISO 8601. Present only on tombstone rows. This can be earlier than `dateModified` after a delayed backfill: `dateModified` is the later visible-at timestamp used for delta matching, ordering, and `deleted` / `trashed` retention. - `mergedInto` string: On a `merged` tombstone (see `deletionStatus`), the `identifier` of the surviving record this one was folded into. Repoint cached references from `identifier` to `mergedInto`. - `member` object[]: For bands, an array of the band's members - … - `memberOf` object[]: For musicians, an array of the band's the musician is a member of - … - `foundingLocation` object: The hometown of the artist - … - `foundingDate` string, iso-8601: The year the artist first performed - `genre` EnumGenres[] - `events` union[]: Only available when using `expandUpcomingEvents=true` and/or `expandUpcomingStreams=true` URL param. - … - `x-bandOrMusician` 'band' | 'musician' - `x-numUpcomingEvents` number: The number of upcoming events for this artist. - `x-externalIdentifiers` unknown[] - … - `x-performanceDate` string, iso-8601: The date of the performance using ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)] - `x-performanceRank` number: The "rank" for this performance whithin the event - `x-isHeadliner` boolean: If this performer is a headliner - `x-dateIsConfirmed` boolean: Required for Festivals. If a Festival performance date is confirmed or not.\ If not, it will appear on the first day of the Festival. - `eventAttendanceMode` 'mixed' | 'offline' | 'online': Indicates whether it occurs online, offline, or a mix. - `isAccessibleForFree` boolean - `x-promoImage` string, uri: A secondary promotional image for the event (e.g. admat) - `@type` 'Festival', required - `deletionStatus` 'deleted' | 'trashed' | 'merged': Present ONLY on tombstone rows returned by delta polls of currently sourced core feeds (requests that include `dateModifiedFrom`). This removal discriminator is separate from the live scheduling field `eventStatus`: - `deleted` — permanently removed; drop the cached row. - `trashed` — soft-deleted (events only; not an `eventStatus`). Treat the same as `deleted` and drop the cached row. - `merged` — folded into another record; repoint cached references to `mergedInto`. A tombstone row carries only `@type`, `identifier`, `deletionStatus`, `deletedAt`, `dateModified`, and (when `merged`) `mergedInto`. Tombstones count toward `perPage` and `pagination.totalItems` and are appended after live rows. For `deleted` / `trashed`, retention is 90 days from the visible-at `dateModified`; `merged` tombstones never expire. `deletedAt` is the true removal time and can be earlier than `dateModified` after a delayed backfill. Queries without `dateModifiedFrom` never return tombstones. Since 2026-10-29, delta queries filtered by artist or venue carry only matching tombstones: on events, `artistId` matches an artist in the removed event's lineup and `venueId` its venue, both as recorded when the event was removed (a `merged` event matches on the removed event, not the surviving one); on artists and venues, a merged record matches a filter on its own identifier. Their `pagination.totalItems` / `totalPages` count live rows plus the matching tombstones. Removals with no recorded artist or venue (mostly from before 2026-10-29) and deltas filtered by `artistSlug`, `artistName`, `venueSlug`, or `venueName` carry none. To see every removal, run one unfiltered `dateModifiedFrom` sweep (geo and date filters still carry all tombstones), or treat a `400 identifier_invalid` single-record lookup as removed. Current source coverage: events (`deleted`, `trashed`, `merged`), festivals (`deleted`), artists / venues / festival collections (`merged`), and no stream tombstones. - `deletedAt` string, iso-8601: The true upstream time when the record left the catalog, in ISO 8601. Present only on tombstone rows. This can be earlier than `dateModified` after a delayed backfill: `dateModified` is the later visible-at timestamp used for delta matching, ordering, and `deleted` / `trashed` retention. - `mergedInto` string: On a `merged` tombstone (see `deletionStatus`), the `identifier` of the surviving record this one was folded into. Repoint cached references from `identifier` to `mergedInto`. - `x-lineupDisplayOption` 'full' | 'daybyday', required: Whether to display the `full` lineup or a `daybyday` breakdown - `x-customTitle` string: To replace the default `event[name]` property ## Other responses - `400`: Invalid input parameter - `401`: API key is missing or invalid ## Changes - **2026-08-15** `4b1c88c8e56d`: 6 info - added the optional property `stream/allOf[subschema #2]/broadcastOfEvent/items/oneOf[subschema #2: Festival]/allOf[subschema #2]/deletedAt` to the response with the `200` status - added the optional property `stream/allOf[subschema #2]/broadcastOfEvent/items/oneOf[subschema #2: Festival]/allOf[subschema #2]/deletionStatus` to the response with the `200` status - added the optional property `stream/allOf[subschema #2]/broadcastOfEvent/items/oneOf[subschema #2: Festival]/allOf[subschema #2]/mergedInto` to the response with the `200` status - added the optional property `stream/allOf[subschema #2]/deletedAt` to the response with the `200` status - …2 more [Operation history](https://skmtc.dev/jambase/apis/jambase-concert-data-api/changes/streams/id/:streamDataSource::streamId/get.md) --- [API](https://skmtc.dev/jambase/apis/jambase-concert-data-api.md) - [All operations](https://skmtc.dev/jambase/apis/jambase-concert-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jambase/apis/jambase-concert-data-api/revisions/487fb580fa61?raw)