Organizations

TvSportsData/Organizations

Returns all sports organizations. Organizations represent teams (e.g. Philadelphia Eagles), leagues (e.g. NFL), conferences (e.g. NFC) and divisions (e.g.. NFC East).

Response schema: http://gns-schemas.sports.gracenote.com/gns.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 Yes

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

Response Body

Response

Description

id

Unique Gracenote id for the organization.

update_id The update id for the organization.
update_action The update action for the organization.
update_date The update date and time for the organization.

xids

Container for external ids to connect to data in other Gracenote APIs and/or legacy data.

supplier Name of the supplier (e.g. sportsdirect, infostrada) of the xid.
type The description of the supplier's id keyspace.
id The supplier's id for the associated entity.
type The type of organization(e.g. LEAGUE, CONFERENCE, TEAM etc.).
sport_id The id for the sport related to the organization.
gender The gender of the organization (e.g. MALE, FEMALE, MIXED).
parent_sports_organization_ids The ids for any parent organization for the organization.
name The name(s) of the organization.
type The type of name for the organization (e.g. DEFAULT, NICK, FIRST, SHORT).
value The value for the type of name for the organization (e.g. Major League Baseball, Toronto).
location The location for the organization.
city The city for the organization.
state The state for the organization, if applicable.
country The country for the organization.

 

Sample Response(s)

 

ORGANIZATION (LEAGUE):

<gns:gns xmlns:gns="http://xml.gracenote.com/gns/v1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="gns.xsd">
        <sports_organizations>
            <sports_organization>
                <id>GNCH1JZA56P7PKE</id>
                <meta>
                    <update_id>4340034</update_id>
                    <update_action>UPDATE</update_action>
                    <update_date>2017-06-12T05:28:11Z</update_date>
                </meta>
                <xids>
                    <xid>
                        <supplier>sportsdirect</supplier>
                        <type>xml</type>
                        <id>/sport/baseball/league:1219</id>
                    </xid>
                </xids>
                <type>LEAGUE</type>
                <sport_id>GN3FAZE2HJTVDJ9</sport_id>
                <names>
                    <name>
                        <type>DEFAULT</type>
                        <value>Major League Baseball</value>
                    </name>
                    <name>
                        <type>NICK</type>
                        <value>MLB</value>
                    </name>
                </names>
            </sports_organization>
        </sports_organizations>
    </gns:gns>

ORGANIZATION (TEAM):

<gns:gns xmlns:gns="http://xml.gracenote.com/gns/v1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="gns.xsd">
        <sports_organizations>
            <sports_organization>
                <id>GNE34R821XNK29B</id>
                <meta>
                    <update_id>4340049</update_id>
                    <update_action>UPDATE</update_action>
                    <update_date>2017-06-12T05:28:12Z</update_date>
                </meta>
                <xids>
                    <xid>
                        <supplier>sportsdirect</supplier>
                        <type>xml</type>
                        <id>/sport/baseball/team:2970</id>
                    </xid>
                </xids>
                <type>TEAM</type>
                <sport_id>GN3FAZE2HJTVDJ9</sport_id>
                <gender>MALE</gender>
                <names>
                    <name>
                        <type>DEFAULT</type>
                        <value>NY Yankees</value>
                    </name>
                    <name>
                        <type>FIRST</type>
                        <value>New York</value>
                    </name>
                    <name>
                        <type>NICK</type>
                        <value>Yankees</value>
                    </name>
                    <name>
                        <type>SHORT</type>
                        <value>NYY</value>
                    </name>
                </names>
                <location>
                    <city>New York</city>
                    <state>New York</state>
                    <country>USA</country>
                </location>
            </sports_organization>
        </sports_organizations>
    </gns:gns>