Organizations

sports/v1/Organizations

Instances of leagues, conferences and divisions.

Response schema: http://developer.tmsapi.com/files/gracenote_sports_organizations_1.0.xsd

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 No

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

sportId No Comma-separated list of sport identifiers; can be used to filter events, organizationSeasons and teamSeasons APIs.

Response Body

Response

Description

organizationId

Organizationidentifier.

updateId

Update Id for the entry

name

The name of the organization (i.e.; Premier League.)

officialName

The official name of the organization. (i.e.; Barclays Premier League)

parentOrganization

The parent organization.

id

parentOrganization identifier

name

 

type

Reference to the type of the organization.

id

Type identifier

name

The name of the organization type (i.e.;  governing body)

sport

The related sport for the organization.

sportId

Unique id for the sport.

name

The name of the sport.

Sample Response

 

<?xml version="1.0" encoding="UTF-8" ?>
<gracenoteSports xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="gracenote_sports_organizations_1.0.xsd" schemaVersion="1.0">
    <header>
        <content>Gracenote Sports - Organizations</content>
        <created>2015-09-03T21:42:12Z</created>
        <copyright>Copyright 2015-present. Gracenote, Inc. All rights reserved.</copyright>
        <requestParameters>
            <requestParameter name="updateId">0</requestParameter>
            <requestParameter name="limit">5</requestParameter>
        </requestParameters>
    </header>
    <organizations>
        <organization  organizationId="17592186281743" updateId="155"   >
            <name lang="en">Conference USA</name>
            <officialName lang="en">Conference USA</officialName>
            <parentOrganization>
                <organization organizationId="17592186281734">
                    <name lang="en">Division I Football Bowl Subdivision</name>
                </organization>
            </parentOrganization>
            <type typeId="17592186045479">
                <name lang="en">Conference</name>
            </type>
            <sport sportId="17592186045467">
                <name lang="en">Football</name>
            </sport>
        </organization>
        <organization  organizationId="17592186281734" updateId="156"   >
            <name lang="en">Football Bowl Subdivision</name>
            <officialName lang="en">Division I Football Bowl Subdivision</officialName>
            <parentOrganization>
                <organization organizationId="17592186281733">
                    <name lang="en">National Collegiate Athletic Association - Football</name>
                </organization>
            </parentOrganization>
            <type typeId="17592186045478">
                <name lang="en">League</name>
            </type>
            <sport sportId="17592186045467">
                <name lang="en">Football</name>
            </sport>
        </organization>
        <organization  organizationId="17592186281742" updateId="157"   >
            <name lang="en">Big Ten, East</name>
            <officialName lang="en">Big Ten Conference, East Division</officialName>
            <parentOrganization>
                <organization organizationId="17592186281740">
                    <name lang="en">Big Ten Conference</name>
                </organization>
            </parentOrganization>
            <type typeId="17592186045480">
                <name lang="en">Division</name>
            </type>
            <sport sportId="17592186045467">
                <name lang="en">Football</name>
            </sport>
        </organization>
        <organization  organizationId="17592186281733" updateId="158"   >
            <name lang="en">NCAA Football</name>
            <officialName lang="en">National Collegiate Athletic Association - Football</officialName>
            <parentOrganization>
                <organization organizationId="17592186281732">
                    <name lang="en">National Collegiate Athletic Association</name>
                </organization>
            </parentOrganization>
            <type typeId="17592186045474">
                <name lang="en">Governing Body</name>
            </type>
            <sport sportId="17592186045467">
                <name lang="en">Football</name>
            </sport>
        </organization>
        <organization  organizationId="17592186281736" updateId="159"   >
            <name lang="en">Atlantic Coast, Coastal</name>
            <officialName lang="en">Atlantic Coast Conference, Coastal Division</officialName>
            <parentOrganization>
                <organization organizationId="17592186281735">
                    <name lang="en">Atlantic Coast Conference</name>
                </organization>
            </parentOrganization>
            <type typeId="17592186045480">
                <name lang="en">Division</name>
            </type>
            <sport sportId="17592186045467">
                <name lang="en">Football</name>
            </sport>
        </organization>
    </organizations>
</gracenoteSports>