Search Venues

Page number of results to retrieve

Number of events per page of results

The source and unique identifier for the venue(s)

• venueId=jambase:62108

Use a pipe (|) to include multiple venue IDs

• venueId=jambase:62108|jambase:7932731

To use non-JamBase IDs, use the <a href="https://data.jambase.com/api/reference/get-venue-data-sources">source slug</a> for the ID(s) you are using

• venueId=ticketmaster:k7vGF99ORYpnS

A keyword-based search for venue name(s).

• venueName=Brooklyn%20Bowl

Use a pipe (|) to include multiple venue IDs.

• venueName=Brooklyn%20Bowl|House%20of%20Blues

For more precise venue-specific results try using venueId or venue[slug].

Use to retrieve events for specific <a href="https://data.jambase.com/api/reference/search-cities">JamBase city ID(s)</a> .

• geoCityId=jambase:4223296

Use a pipe (|) to include multiple city IDs.

• geoCityId=jambase:4223296|jambase:4224564

When using the geoCityId parameter, you can omit the the geoRadiusAmount parameter (or) set it to 0 (or) leave it empty to include only results from the city. Else, you can use a radius amount to include events within a radius around the city-center.

Use to retrieve events for city name(s).

• geoCityName=Seattle

Use a pipe (|) to include multiple city names.

• geoCityName=Seattle|Tacoma

For more precise city-specific results try using city[id]

The two-letter ISO 3166-1 alpha-2 code for a country.

• geoCountryIso2=US

Use a pipe (|) to include multiple countries.

• geoCountryIso2=US|CA

Geographic filters alone request the normal upcoming-events dataset, even on historically entitled subscriptions; dateModifiedFrom alone is not historical intent either. On plans with geo + historical search (Enterprise baseline, or granted by request), request history explicitly with a licensed past event-date window or expandPastEvents=true. For country-by-country historical backfills, prefer bounded eventDateFrom/eventDateTo windows with no expand flag needed. An authorized historical request with no lower event-date bound receives the later fixed subscription date and rolling plan/override floor before origin fetch; truly unlimited history gets no invented floor. Iterate only countries that actually have data for your target date range (ask support for the coverage list) rather than sweeping every ISO code. Note the code for the United Kingdom is GB, not UK — source data occasionally shows UK, but this filter expects GB.

The three-letter ISO code for a country.

• geoCountryIso3=USA

Use a pipe (|) to include multiple countries.

• geoCountryIso3=USA|CAN

Use to retrieve events near an IP address.
Supports IPv4 or IPv6 values.

• geoIp=55.123.456.789

The latitude for geographic radius.

• geoLatitude=40.7505

The longitude for geographic radius.

• geoLongitude=-73.9934

Use to retrieve events for specific <a href="https://data.jambase.com/api/reference/get-metros">metro ID(s)</a>.

• geoMetroId=jambase:1

Use a pipe (|) to include multiple metro IDs.

• geoMetroId=jambase:1|jambase:5

The search radius for lat/lng type searches.

• geoRadiusAmount=60

Whether to use miles (default) or kilometers for radius.

• geoRadiusUnits=km

The State code in ISO_3166-2 format [docs].

• geoStateIso=US-NY

Use a pipe (|) to include multiple State codes.

• geoStateIso=US-NY|=US-PA

Note: Available for United States, Canada, and Australia only.

Must have been updated on or after this dateTime in GMT.
If left blank or omitted, will use all updated on dates

• dateModifiedFrom=2022-10-31 00:00:00

On its own, a dateModifiedFrom sweep only returns events whose dates have not yet passed — modifications to past-dated events never appear in a plain delta sweep. To catch changes to past shows, plans with geo + historical search (Enterprise baseline, or granted by request) can combine dateModifiedFrom with a geo parameter (such as geoCountryIso2) and an explicit past eventDateFrom/eventDateTo range. Two caveats: the historical index refreshes on a delay (up to about a day), so overlap historical watermarks by 24-48 hours; and a response carrying the X-JBD-Geo-Historical-Fallback header was served without past events and should be re-run after the UTC day resets.

Removal rows (tombstones carrying deletionStatus) are appended to delta sweeps. A delta filtered by artistId or venueId carries only the removal rows for events that had that artist in the lineup or were at that venue when removed, and its totals count only those. Removals with no recorded artist or venue (mostly from before 2026-10-29) and slug/name-filtered deltas carry none; to see every removal, run one unfiltered dateModifiedFrom sweep or use the 400 identifier_invalid lookup fallback.

Note: Use <a href="https://www.rfc-editor.org/rfc/rfc3339#section-5.6">RFC3339</a> format for parameter values.

Must have been first published on or after this dateTime in GMT.

If left blank or omitted, will use all first published on dates.

• datePublishedFrom=2022-01-01 00:00:00

Note: Use <a href="https://www.rfc-editor.org/rfc/rfc3339#section-5.6">RFC3339</a> format for parameter values.

Set to true to only return venues that have at least one upcoming event

Use true to include external IDs for Concert, Artist, and Venue objects.
Note: expandExternalIdentifiers is included on Startup and higher plans and on Trial. Looking up a record by a third-party ID (for example /v3/artists/id/spotify:{id}) works on every plan; see Reverse ID Lookup.