Returns all sports venues.

Response schema:

Request Parameters

Parameter Mandatory Description
updateId Yes

Token-based update retrieval. Updates will be retrieved with specified updateId value. For full seeding, specify updateId=0. Increment max updateId by one to retrieve next set of updated records.

limit Yes

Maximum number of objects to retrieve for processing predictiable batch sizes. Each iteration would retain limit number for same batch size.

Response Body




Unique Gracenote id for the venue.

update_id The update id for the venue.
update_action The update action for the venue.
update_date The update date and time for the venue.


Container for external ids to connect to data in other Gracenote APIs and/or legacy data.

supplier Name of the supplier (e.g. sportsdirect, infostrada, onsports, tms) of the xid.
type The description of the supplier's id keyspace.
id The supplier's id for the associated entity.
name The name(s) of the venue.
type The type of name for the venue (e.g. DEFAULT, SHORT).
value The value for the type of name for the venue (e.g. Yankee Stadium)
location The location for the venue.
city The city for the venue.
state The state for the venue, if applicable.
country The country for the venue.


Sample Response(s)



<gns:gns xmlns:gns="" xmlns:xsi="" xsi:schemaLocation="gns.xsd">
                        <value>Yankee Stadium</value>
                    <state>New York</state>