JamBase Events API is one of 7 APIs that JamBase publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
This API exposes 1 JSON Schema definition.
Tagged areas include Events. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a getting-started guide, pricing, rate-limit docs, and 1 JSON Schema.
This API exposes
2 operations
across 2 paths,
and defines 39 schemas.
It is described by OpenAPI 3.1.0, at version 3.1.0.
Requests are made against a single base URL, https://api.data.jambase.com/v3.
2 operations2 paths39 schemas2 GET
Metadata
The identity and technical contract details declared by the specification.
JamBase Events API declares
1 security scheme
for authenticating requests.
It accepts HTTP bearer tokens (BearerAuth).
By default, every request must be authenticated.
BearerAuth — API key as Bearer token. Get your key from your account dashboard.
Paths & Operations 2
Across 2 paths, the API surfaces 2 operations — 2 GET. Each is listed below with its method, path, parameters, and response codes.
Events 2
Search Events
GET
/events
Search Events
searchEvents31 params→ 200400401
GET
/events/id/{eventDataSource}:{eventId}
Get / reverse-lookup an Event by JamBase or third-party ID
getUpcomingEvent5 params→ 200400401
Schemas 39
The contract defines 39 schemas that model the data the API accepts and returns. The most detailed are PostalAddress (10 properties), Thing (7 properties), Pagination (6 properties), State (6 properties). Each schema is shown below with its type and property counts.
propLatitude
number
The latitude of a location
URL
object
A third-party link.
3 properties
GeoCoordinates
object
The latitude and longitude for a place
3 properties
Request
object
Enclosure for request details.
5 properties
propMergedInto
string
On a merged tombstone (see deletionStatus), the identifier of the surviving record this one was folded into. Repoint cached references from identifier to merge…
Pagination
object
Enclosure for pagination values.
6 properties
Offer
object
Something for sale, typically a concert ticket
5 required
PriceSpecification
object
The price or price range for the thing
5 properties2 required
propLongitude
number
The longitude of a location
MusicVenue
object
A place to Go See Live Music
enumRadiusUnits
string
The units of measure for a geo search radius
Event
object
A generic event.Please note that startDate,endDate,previousStartDate, and doorTime are all returned based on the venue's local time but without an offset. You…
State
object
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 p…
6 properties
Country
object
A Country.
5 properties
Organization
object
An organization or business.\ Typically a ticket vendor or data source in this API.\ The identifier or "slug" can also be used as ticket[vendor][id] in /events…
5 required
enumCountryIso2
string
The Country code in ISO 3166-1 alpha-2 format [[docs](https://en.wikipedia.org/wiki/ISO3166-1alpha-2)].
propDeletedAt
string
The moment the record left the catalog, in ISO 8601. Present only on tombstone rows (see deletionStatus). Equals the row's dateModified so the same dateModifie…
Success
boolean
A successful response.
enumVenueDataSource
string
Data source slugs to use for Venue IDs
Stream
object
A stream
8 required
ExternalIdentifier
object
A third-party non-JamBase ID for an artist, venue, or event.
3 properties
enumAttendanceMode
string
Indicates whether it occurs online, offline, or a mix.
ErrorsList
array
A list of errors
enumGenres
string
Music genres
Thing
object
A generic thing
7 properties
propDeletionStatus
string
Present ONLY on tombstone rows returned by delta polls of the core feeds (i.e. requests that include dateModifiedFrom). Marks a record that has left the catalo…
enumUrlType
string
The type of the external URL
enumArtistDataSource
string
Data source slugs to use for Artist IDs
MusicGroup
object
A band or musician
enumEventType
string
The type of event being requested
PostalAddress
object
A postal address, typically for a MusicVenue
10 properties
enumCountryIso3
string
The Country code in ISO 3166-1 alpha-3 format [[docs](https://en.wikipedia.org/wiki/ISO3166-1alpha-3)].
enumDatePresets
string
Presets for frequently used date ranges.
enumEventStatus
string
The scheduling status for the event
Concert
object
A concert / show
8 required
enumState
string
A State code in ISO 3166-2 format [[docs](https://en.wikipedia.org/wiki/ISO3166-2)].
Festival
object
A music festival
10 required
enumEventDataSource
string
Data source slugs to use for Event IDs
enumFestivalLineupDisplayOption
string
Whether to display the full lineup or a daybyday breakdown
Specification
The full machine-readable OpenAPI contract behind this narrative.
