Venues API

Get Venues by Location

Search for venues near a geographic point.


Method	GET
Route	`/partner/v1/venue/details/byLocation`

Parameter	Type	Required	Description
`lat`	`Double`	Yes	Latitude
`lon`	`Double`	Yes	Longitude
`radius`	`Double`	Yes	Search radius (max 80km)
`page`	`Int`	No	Page number
`pageSize`	`Int`	No	Results per page (default: 25, max: 100)

Returns VenueDetailsResponse ordered by distance from the provided coordinates.

Look up specific venues by their IDs.


Method	POST
Route	`/partner/v1/venue/details/byIds`

{
  "ids": ["C0057070265"],
  "location": {
    "lat": 34.0195,
    "lon": -118.4912
  }
}

Returns VenueDetailsResponse. If a location is provided in the request, each venue includes kmDistance.

Search for venues matching a text query within a geographic area.


Method	GET
Route	`/partner/v1/venue/details/search`

Parameter	Type	Required	Description
`term`	`String`	Yes	Search query for venue names
`lat`	`Double`	Yes	Latitude
`lon`	`Double`	Yes	Longitude
`radius`	`Double`	Yes	Search radius (max 80km)
`pageSize`	`Int`	No	Results per page
`page`	`Int`	No	Page number

Returns VenueDetailsResponse ordered by distance from the provided coordinates.

Look up an Atom venue using your internal vendor venue ID. Useful for mapping your system’s venue IDs to Atom’s.


Method	GET
Route	`/partner/v1/venues/byVendorVenueId/{vendorVenueId}`

Parameter	Type	Required	Description
`vendorVenueId`	`String`	Yes	Your internal venue identifier

Parameter	Type	Required	Description
`circuitId`	`String`	No	Limit query to a specific theater circuit