TeamSeasons

sports/v1/TeamSeasons

Seasonal instances of teams.

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

teamSeasonId

teamSeason identifier (id for 2015 Cubs)

teamId

Franchise identifier, to associate teams across seasons regardless of name changes.

season

Team season (i.e., 2015).

fullName

Full team name.  (i.e., New York Giants)

firstName

First section of team name (i.e.; New York)

lastName

Last section of team name (i.e.; Giants)

abbreviation

Team name abbreviation (i.e.; NYG)

gender

Male, Female, Mixed

venue

Reference to the team’s primary venue; useful for location-based team queries.

id

Unique identifier for the venue.

name

Name of the venue.

organizationSeason

Reference to the team’s organizations (all parent levels).

id

Unique identifier for the organizationSeason.

name

Name of the organizationSeason

sport

 

id

Unique identifier for the related sport.

Name

Name of the related sport.

 

Sample Response

 

<?xml version="1.0" encoding="UTF-8" ?>
<gracenoteSports xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="gracenote_sports_team_seasons_1.0.xsd" schemaVersion="1.0">
    <header>
        <content>Gracenote Sports - Team Seasons</content>
        <created>2015-09-03T15:11:42Z</created>
        <copyright>Copyright 2015-present. Gracenote, Inc. All rights reserved.</copyright>
        <requestParameters>
            <requestParameter name="updateId">0</requestParameter>
            <requestParameter name="limit">10</requestParameter>
        </requestParameters>
    </header>
    <teamSeasons>
        <teamSeason teamSeasonId="17592186101497" updateId="172"  >
            <teamId>17592186099844</teamId>
            <season>2015</season>
            <fullName lang="en">Milwaukee Brewers</fullName>
            <firstName lang="en">Milwaukee</firstName>
            <lastName lang="en">Brewers</lastName>
            <abbreviation lang="en">MIL</abbreviation>
            <gender>Male</gender>
            <venue>
                <id>17592186047726</id>
                <name lang="en">Miller Park</name>
            </venue>
            <organizationSeason>
                <id>17592186101495</id>
                <name lang="en">NL Central</name>
            </organizationSeason>
            <sport>
                <id>17592186045466</id>
                <name lang="en">Baseball</name>
            </sport>
        </teamSeason>
        <teamSeason teamSeasonId="17592186101499" updateId="173"  >
            <teamId>17592186099674</teamId>
            <season>2015</season>
            <fullName lang="en">St. Louis Cardinals</fullName>
            <firstName lang="en">St. Louis</firstName>
            <lastName lang="en">Cardinals</lastName>
            <abbreviation lang="en">STL</abbreviation>
            <gender>Male</gender>
            <venue>
                <id>17592186047079</id>
                <name lang="en">Busch Stadium</name>
            </venue>
            <organizationSeason>
                <id>17592186101495</id>
                <name lang="en">NL Central</name>
            </organizationSeason>
            <sport>
                <id>17592186045466</id>
                <name lang="en">Baseball</name>
            </sport>
        </teamSeason>
        <teamSeason teamSeasonId="17592186101505" updateId="174"  >
            <teamId>17592186099931</teamId>
            <season>2015</season>
            <fullName lang="en">Pittsburgh Pirates</fullName>
            <firstName lang="en">Pittsburgh</firstName>
            <lastName lang="en">Pirates</lastName>
            <abbreviation lang="en">PIT</abbreviation>
            <gender>Male</gender>
            <venue>
                <id>17592186047972</id>
                <name lang="en">PNC Park</name>
            </venue>
            <organizationSeason>
                <id>17592186101495</id>
                <name lang="en">NL Central</name>
            </organizationSeason>
            <sport>
                <id>17592186045466</id>
                <name lang="en">Baseball</name>
            </sport>
        </teamSeason>
        <teamSeason teamSeasonId="17592186101531" updateId="175"  >
            <teamId>17592186099998</teamId>
            <season>2015</season>
            <fullName lang="en">New York Mets</fullName>
            <firstName lang="en">New York</firstName>
            <lastName lang="en">Mets</lastName>
            <abbreviation lang="en">NYM</abbreviation>
            <gender>Male</gender>
            <venue>
                <id>17592186048255</id>
                <name lang="en">Citi Field</name>
            </venue>
            <organizationSeason>
                <id>17592186101526</id>
                <name lang="en">NL East</name>
            </organizationSeason>
            <sport>
                <id>17592186045466</id>
                <name lang="en">Baseball</name>
            </sport>
        </teamSeason>
        <teamSeason teamSeasonId="17592186101521" updateId="176"  >
            <teamId>17592186099777</teamId>
            <season>2015</season>
            <fullName lang="en">Los Angeles Dodgers</fullName>
            <firstName lang="en">Los Angeles</firstName>
            <lastName lang="en">Dodgers</lastName>
            <abbreviation lang="en">LA</abbreviation>
            <gender>Male</gender>
            <venue>
                <id>17592186047278</id>
                <name lang="en">Dodger Stadium</name>
            </venue>
            <organizationSeason>
                <id>17592186101507</id>
                <name lang="en">NL West</name>
            </organizationSeason>
            <sport>
                <id>17592186045466</id>
                <name lang="en">Baseball</name>
            </sport>
        </teamSeason>
        <teamSeason teamSeasonId="17592186101510" updateId="177"  >
            <teamId>17592186099658</teamId>
            <season>2015</season>
            <fullName lang="en">San Francisco Giants</fullName>
            <firstName lang="en">San Francisco</firstName>
            <lastName lang="en">Giants</lastName>
            <abbreviation lang="en">SF</abbreviation>
            <gender>Male</gender>
            <venue>
                <id>17592186046978</id>
                <name lang="en">AT&amp;T Park</name>
            </venue>
            <organizationSeason>
                <id>17592186101507</id>
                <name lang="en">NL West</name>
            </organizationSeason>
            <sport>
                <id>17592186045466</id>
                <name lang="en">Baseball</name>
            </sport>
        </teamSeason>
        <teamSeason teamSeasonId="17592186101516" updateId="178"  >
            <teamId>17592186099915</teamId>
            <season>2015</season>
            <fullName lang="en">San Diego Padres</fullName>
            <firstName lang="en">San Diego</firstName>
            <lastName lang="en">Padres</lastName>
            <abbreviation lang="en">SD</abbreviation>
            <gender>Male</gender>
            <venue>
                <id>17592186047926</id>
                <name lang="en">PETCO Park</name>
            </venue>
            <organizationSeason>
                <id>17592186101507</id>
                <name lang="en">NL West</name>
            </organizationSeason>
            <sport>
                <id>17592186045466</id>
                <name lang="en">Baseball</name>
            </sport>
        </teamSeason>
        <teamSeason teamSeasonId="17592186101535" updateId="179"  >
            <teamId>17592186099878</teamId>
            <season>2015</season>
            <fullName lang="en">Washington Nationals</fullName>
            <firstName lang="en">Washington</firstName>
            <lastName lang="en">Nationals</lastName>
            <abbreviation lang="en">WAS</abbreviation>
            <gender>Male</gender>
            <venue>
                <id>17592186047809</id>
                <name lang="en">Nationals Park</name>
            </venue>
            <organizationSeason>
                <id>17592186101526</id>
                <name lang="en">NL East</name>
            </organizationSeason>
            <sport>
                <id>17592186045466</id>
                <name lang="en">Baseball</name>
            </sport>
        </teamSeason>
        <teamSeason teamSeasonId="17592186101503" updateId="180"  >
            <teamId>17592186100064</teamId>
            <season>2015</season>
            <fullName lang="en">Chicago Cubs</fullName>
            <firstName lang="en">Chicago</firstName>
            <lastName lang="en">Cubs</lastName>
            <abbreviation lang="en">CHC</abbreviation>
            <gender>Male</gender>
            <venue>
                <id>17592186048558</id>
                <name lang="en">Wrigley Field</name>
            </venue>
            <organizationSeason>
                <id>17592186101495</id>
                <name lang="en">NL Central</name>
            </organizationSeason>
            <sport>
                <id>17592186045466</id>
                <name lang="en">Baseball</name>
            </sport>
        </teamSeason>
        <teamSeason teamSeasonId="17592186101523" updateId="181"  >
            <teamId>17592186099699</teamId>
            <season>2015</season>
            <fullName lang="en">Arizona Diamondbacks</fullName>
            <firstName lang="en">Arizona</firstName>
            <lastName lang="en">Diamondbacks</lastName>
            <abbreviation lang="en">ARI</abbreviation>
            <gender>Male</gender>
            <venue>
                <id>17592186047106</id>
                <name lang="en">Chase Field</name>
            </venue>
            <organizationSeason>
                <id>17592186101507</id>
                <name lang="en">NL West</name>
            </organizationSeason>
            <sport>
                <id>17592186045466</id>
                <name lang="en">Baseball</name>
            </sport>
        </teamSeason>
    </teamSeasons>
</gracenoteSports>