Find Sport by Sport ID

gns-api/sports

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

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

Request Parameters

Parameter Mandatory Description
sportId Yes

If a sport’s Gracenote id is known, you can use that to find the sport.

Accept Yes

Choose between XML and JSON for the response..

fields No Allows you to return the id(s) and a specific field(s) in the response. In the case of sports, this is limited to "names".

Response Body

Response Description
id Unique Gracenote id for the sport.
names
type The type of name for sports is DEFAULT.
value Name of the sport. (e.g. Baseball). 
xids
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.

Sample

Sample Request

sportId: GN3FAZE2HJTVDJ9

Sample Response

 

<sport>
	<id>GN3FAZE2HJTVDJ9</id>
	<meta>
		<update_date>2017-05-26T01:07:16Z</update_date>
	</meta>
	<xids>
		<xid>
			<supplier>sportsdirect</supplier>
			<type>xml</type>
			<id>/sport/baseball</id>
		</xid>
	</xids>
	<names>
		<name>
			<type>DEFAULT</type>
			<value>Baseball</value>
		</name>
	</names>
</sport>