JamBase Venues 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 Venues. 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 37 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 paths37 schemas2 GET
Metadata
The identity and technical contract details declared by the specification.
JamBase Venues 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.
Venues 2
Search Venues
GET
/venues
Search Venues
searchVenues18 params→ 200400401
GET
/venues/id/{venueDataSource}:{venueId}
Get / reverse-lookup a Venue by JamBase or third-party ID
getSingleVenue7 params→ 200400401
Schemas 37
The contract defines 37 schemas that model the data the API accepts and returns. The most detailed are PostalAddress (10 properties), Thing (7 properties), State (6 properties), Pagination (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…
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
Country
object
A Country.
5 properties
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
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…
enumVenueDataSource
string
Data source slugs to use for Venue IDs
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
MusicGroup
object
A band or musician
enumArtistDataSource
string
Data source slugs to use for Artist IDs
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)].
Stream
object
A stream
8 required
enumEventStatus
string
The scheduling status for the event
enumState
string
A State code in ISO 3166-2 format [[docs](https://en.wikipedia.org/wiki/ISO3166-2)].
Success
boolean
A successful response.
Concert
object
A concert / show
8 required
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.
