SportsEvents Endpoint

The SportsEvents endpoint provides the information on the SportsEvent of type League, League_Season, Phase and Match as referenced in the programs. Each type will give more detailed information on for example the teams participating in that league or the status and teams participating in a match.

API and Example Responses

API:

http://on-api.gracenote.com/v3/SportsEvents
?updateId=[updateId value]
&limit=[limit value]
&api_key=[your-api-key]

Example Requests

Return full list of organizations.

http://on-api.gracenote.com/v3/SportsEvents?updateId=0&limit=1000&api_key=<your-api-key>

Request Parameters

Parameter

Required?

Description

api_key

Yes

24-character key obtained during application registration

updateId

No

Update token. Defaults to 0. Returns sports beginning with updateId, which is a sequential numeric offset received in response.

limit

No

Batch size. Maximum number of sports to be returned by API. Use with updateId.

sportEventGId

No

For non-batch lookups. Comma-separated list of sportEventGIds. Overrides updateId.

Data Structure and Relationships

Schema

Review the following XML schema definition (xsd) to learn about the data structure, fields, and types for this endpoint.

To explore the relationships among all endpoints, see the interactive schema documentation.

XML Schema URL:http://files.api.gracenote.com/xsd/on_update_sports_events_3.23.xsd