OrganizationSeasons

sports/v1/OrganizationSeasons

Seasonal instances of leagues, conferences and divisions.

Response schema: http://developer.tmsapi.com/files/gracenote_sports_organization_seasons_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

id

OrganizationSeason identifier.

organizationId

Unique id for the organization.

season

Organization season i.e.; 2015

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.

id

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_organization_seasons_1.0.xsd" schemaVersion="1.0">
    <header>
        <content>Gracenote Sports - Organization Seasons</content>
        <created>2015-09-03T14:58:38Z</created>
        <copyright>Copyright 2015-present. Gracenote, Inc. All rights reserved.</copyright>
        <requestParameters>
            <requestParameter name="updateId">0</requestParameter>
            <requestParameter name="limit">10</requestParameter>
        </requestParameters>
    </header>
    <organizationSeasons>
        <organizationSeason  organizationSeasonId="17592186101491" updateId="24"   >
            <organizationId>17592186045490</organizationId>
            <season>2015</season>
            <name lang="en">MLB Baseball</name>
            <officialName lang="en">Major League Baseball</officialName>
            <type>
                <id>17592186045474</id>
                <name lang="en">Governing Body</name>
            </type>
            <sport>
                <id>17592186045466</id>
                <name lang="en">Baseball</name>
            </sport>
            <logos>
                <asset assetId="o17_l_h5_aa" type="image/png" width="180" height="135" category="Logo" tier="Organization">
                    <URI>assets/o17_l_h5_aa.png</URI>
                </asset>
                <asset assetId="o17_l_h6_aa" type="image/png" width="720" height="540" category="Logo" tier="Organization">
                    <URI>assets/o17_l_h6_aa.png</URI>
                </asset>
                <asset assetId="o17_l_h3_aa" type="image/png" width="360" height="270" category="Logo" tier="Organization">
                    <URI>assets/o17_l_h3_aa.png</URI>
                </asset>
                <asset assetId="o17_l_h9_aa" type="image/png" width="1440" height="1080" category="Logo" tier="Organization">
                    <URI>assets/o17_l_h9_aa.png</URI>
                </asset>
            </logos>
        </organizationSeason>
        <organizationSeason  organizationSeasonId="17592186101495" updateId="25"   >
            <organizationId>17592186045497</organizationId>
            <season>2015</season>
            <name lang="en">NL Central</name>
            <officialName lang="en">National League Central</officialName>
            <parentOrganization>
                <id>17592186045495</id>
                <name lang="en">National League</name>
            </parentOrganization>
            <type>
                <id>17592186045480</id>
                <name lang="en">Division</name>
            </type>
            <sport>
                <id>17592186045466</id>
                <name lang="en">Baseball</name>
            </sport>
        </organizationSeason>
        <organizationSeason  organizationSeasonId="17592186101493" updateId="26"   >
            <organizationId>17592186045495</organizationId>
            <season>2015</season>
            <name lang="en">National League</name>
            <officialName lang="en">National League</officialName>
            <parentOrganization>
                <id>17592186045490</id>
                <name lang="en">Major League Baseball</name>
            </parentOrganization>
            <type>
                <id>17592186045479</id>
                <name lang="en">Conference</name>
            </type>
            <sport>
                <id>17592186045466</id>
                <name lang="en">Baseball</name>
            </sport>
            <logos>
                <asset assetId="c1004_l_h3_aa" type="image/png" width="360" height="270" category="Logo" tier="Organization">
                    <URI>assets/c1004_l_h3_aa.png</URI>
                </asset>
                <asset assetId="c1004_l_h5_aa" type="image/png" width="180" height="135" category="Logo" tier="Organization">
                    <URI>assets/c1004_l_h5_aa.png</URI>
                </asset>
                <asset assetId="c1004_l_h6_aa" type="image/png" width="720" height="540" category="Logo" tier="Organization">
                    <URI>assets/c1004_l_h6_aa.png</URI>
                </asset>
                <asset assetId="c1004_l_h9_aa" type="image/png" width="1440" height="1080" category="Logo" tier="Organization">
                    <URI>assets/c1004_l_h9_aa.png</URI>
                </asset>
            </logos>
        </organizationSeason>
        <organizationSeason  organizationSeasonId="17592186101507" updateId="27"   >
            <organizationId>17592186045498</organizationId>
            <season>2015</season>
            <name lang="en">NL West</name>
            <officialName lang="en">National League West</officialName>
            <parentOrganization>
                <id>17592186045495</id>
                <name lang="en">National League</name>
            </parentOrganization>
            <type>
                <id>17592186045480</id>
                <name lang="en">Division</name>
            </type>
            <sport>
                <id>17592186045466</id>
                <name lang="en">Baseball</name>
            </sport>
        </organizationSeason>
        <organizationSeason  organizationSeasonId="17592186101526" updateId="28"   >
            <organizationId>17592186045496</organizationId>
            <season>2015</season>
            <name lang="en">NL East</name>
            <officialName lang="en">National League East</officialName>
            <parentOrganization>
                <id>17592186045495</id>
                <name lang="en">National League</name>
            </parentOrganization>
            <type>
                <id>17592186045480</id>
                <name lang="en">Division</name>
            </type>
            <sport>
                <id>17592186045466</id>
                <name lang="en">Baseball</name>
            </sport>
        </organizationSeason>
        <organizationSeason  organizationSeasonId="17592186101556" updateId="29"   >
            <organizationId>17592186045493</organizationId>
            <season>2015</season>
            <name lang="en">AL Central</name>
            <officialName lang="en">American League Central</officialName>
            <parentOrganization>
                <id>17592186045491</id>
                <name lang="en">American League</name>
            </parentOrganization>
            <type>
                <id>17592186045480</id>
                <name lang="en">Division</name>
            </type>
            <sport>
                <id>17592186045466</id>
                <name lang="en">Baseball</name>
            </sport>
        </organizationSeason>
        <organizationSeason  organizationSeasonId="17592186101584" updateId="30"   >
            <organizationId>17592186045494</organizationId>
            <season>2015</season>
            <name lang="en">AL West</name>
            <officialName lang="en">American League West</officialName>
            <parentOrganization>
                <id>17592186045491</id>
                <name lang="en">American League</name>
            </parentOrganization>
            <type>
                <id>17592186045480</id>
                <name lang="en">Division</name>
            </type>
            <sport>
                <id>17592186045466</id>
                <name lang="en">Baseball</name>
            </sport>
        </organizationSeason>
        <organizationSeason  organizationSeasonId="17592186101550" updateId="31"   >
            <organizationId>17592186045491</organizationId>
            <season>2015</season>
            <name lang="en">American League</name>
            <officialName lang="en">American League</officialName>
            <parentOrganization>
                <id>17592186045490</id>
                <name lang="en">Major League Baseball</name>
            </parentOrganization>
            <type>
                <id>17592186045479</id>
                <name lang="en">Conference</name>
            </type>
            <sport>
                <id>17592186045466</id>
                <name lang="en">Baseball</name>
            </sport>
            <logos>
                <asset assetId="c1001_l_h3_aa" type="image/png" width="360" height="270" category="Logo" tier="Organization">
                    <URI>assets/c1001_l_h3_aa.png</URI>
                </asset>
                <asset assetId="c1001_l_h5_aa" type="image/png" width="180" height="135" category="Logo" tier="Organization">
                    <URI>assets/c1001_l_h5_aa.png</URI>
                </asset>
                <asset assetId="c1001_l_h6_aa" type="image/png" width="720" height="540" category="Logo" tier="Organization">
                    <URI>assets/c1001_l_h6_aa.png</URI>
                </asset>
                <asset assetId="c1001_l_h9_aa" type="image/png" width="1440" height="1080" category="Logo" tier="Organization">
                    <URI>assets/c1001_l_h9_aa.png</URI>
                </asset>
            </logos>
        </organizationSeason>
        <organizationSeason  organizationSeasonId="17592186101605" updateId="32"   >
            <organizationId>17592186045492</organizationId>
            <season>2015</season>
            <name lang="en">AL East</name>
            <officialName lang="en">American League East</officialName>
            <parentOrganization>
                <id>17592186045491</id>
                <name lang="en">American League</name>
            </parentOrganization>
            <type>
                <id>17592186045480</id>
                <name lang="en">Division</name>
            </type>
            <sport>
                <id>17592186045466</id>
                <name lang="en">Baseball</name>
            </sport>
        </organizationSeason>
        <organizationSeason  organizationSeasonId="17592186266344" updateId="33"   >
            <organizationId>17592186045500</organizationId>
            <season>2015</season>
            <name lang="en">NFL Football</name>
            <officialName lang="en">National Football League</officialName>
            <type>
                <id>17592186045474</id>
                <name lang="en">Governing Body</name>
            </type>
            <sport>
                <id>17592186045467</id>
                <name lang="en">Football</name>
            </sport>
        </organizationSeason>
    </organizationSeasons>
</gracenoteSports>