Venue Models

Request Models

GetVenueDetailsRequest

Used with the POST /partner/v1/venue/details/byIds endpoint.

GetVenueDetailsRequest {
  ids: List[String],
  location: Option[LatLonPair],
  page: Option[Int],
  pageSize: Option[Int]
}

Field	Type	Required	Description
ids	List[String]	Yes	List of venue IDs to look up
location	LatLonPair	No	If provided, response includes kmDistance for each venue
page	Int	No	Page number for pagination
pageSize	Int	No	Items per page (default: 25, max: 100)

Response Models

Address

Physical address and coordinates of a venue.

Address {
  line: String,
  city: String,
  state: String,
  postal: String,
  lat: Double,
  lon: Double
}

Field	Type	Description
line	String	Street address
city	String	City name
state	String	State abbreviation
postal	String	ZIP / postal code
lat	Double	Latitude
lon	Double	Longitude

Properties

Venue capability flags.

Properties {
  supportsConcessions: Boolean,
  supported: Boolean
}

Field	Type	Description
supportsConcessions	Boolean	Whether the venue supports concession orders through Atom
supported	Boolean	Whether the venue is fully supported on the Atom platform

Venue

Core venue information.

Venue {
  id: String,
  name: String,
  address: Address,
  properties: Properties,
  venueUrl: Option[String],
  atomVenueId: Option[String]
}

Field	Type	Description
id	String	Unique venue identifier
name	String	Venue display name
address	Address	Venue address and coordinates
properties	Properties	Venue capabilities
venueUrl	String?	URL to the venue page on Atom Tickets
atomVenueId	String?	Internal Atom venue ID

VenueDetail

Venue with optional distance information.

VenueDetail {
  venue: Venue,
  kmDistance: Option[Double]
}

Field	Type	Description
venue	Venue	The venue data
kmDistance	Double?	Distance in kilometers from the queried location

VenueDetailsResponse

Top-level response for venue queries.

VenueDetailsResponse {
  venueDetails: List[VenueDetail],
  pageInfo: Option[PageInfo]
}

Field	Type	Description
venueDetails	List[VenueDetail]	List of venue results
pageInfo	PageInfo	Pagination metadata (present for paginated endpoints)