Find Sports Organization by Sport Organization ID

gns-api/sportsorganizations

API to return the sport organization(s) for the specific Sport Organization ID.

Organizations represent...

  • teams (e.g. Philadelphia Eagles)
  • leagues (e.g. NFL)
  • conferences (e.g. NFC)
  • divisions (e.g.. NFC East).

Response Schema: https://gns-schemas.sports.gracenote.com/gns.xsd / https://gns-schemas.sports.gracenote.com/gns.json

Request Parameters

Parameter Mandatory Description
sportsOrganizationId Yes

If you already have a sport organization’s GN id you can use that to find the sport organization.

accept Yes

Choose between XML and JSON for the response..

include No Allows you to "include" full information for an applicable entity in the response.  For example, including "sportId" will add all of the data for "sports" data (id and name) for any sportIds in the reponse.
fields No Allows you to return the id(s) and a specific field(s) in the response. In the case of organizations, this is limited to "names".

Response Body

Response

Description

id

Unique Gracenote id 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, NY Yankees, NYY).
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 

Sample Requests

1. sportsOrganizationId: GNCH1JZA56P7PKE 

2. sportsOrganizationId: GNE34R821XNK29B

Sample Responses

 

 

1. ORGANIZATION (LEAGUE):


        <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>


2. ORGANIZATION (TEAM):

        <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>