The Organizations endpoint provides legacy sports organization metadata. Beginning in On API v3.24, the SportsEvents Endpoint endpoint entity represents the organizational structure of a sport. We recommend using SportsEvents instead of Organizations.
The SportsEvent type LEAGUE is at the top of the hierarchy. More granular event types such include LEAGUE_SEASON, PHASE, ROUND, MATCH, etc. LEAGUE also contains teams, conferences, and divisions in the league.
The Organization endpoint includes links to corresponding SportsEvents entities such as LEAGUE or LEAGUE_SEASON. Also Organization teams, conferences, and divisions include their On Sports identifiers to simplify migration from legacy Sports data to On Sports.
If you are using legacy Sports data, we recommend you migrate to On Sports. The legacy data will be discontinued in the future. Please contact your Gracenote representative for more information about migrating to On Sports.
API and Example Responses
API:
Code
Example Requests
Return full list of organizations.
http://on-api.gracenote.com/v3/Organization?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 teams beginning with updateId, which is sequential numeric offset received in response |
| limit | No | Batch size. Maximum number of organizations to be returned by API. Use with updateId. |
| organizationId | No | For non-batch lookups. Comma-separated list of organizationIds. If not specified, all organizations are included in response. |
Example Response
See: Organization XML examples
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_organizations_3.24.xsd
Organization entity contains the rootId of a Program/Series associated with the organization.