Find Sports Event by Parent Sports Event ID

gns-api/parentsportsevent/<sportsEventId>/sportsevents

API to return the event(s) that have a specific Parent Sports Event ID. Events represent matches (e.g. Philadelphia-NY Giants) as well as league/conference/division seasons (e.g. 2016-2017 NFL, 2016-2017 NFC, 2016-2017 NFC East) and league/conference/division season phases (e.g. NFL 2016-2017 Regular Season, NFL 2016-2017 Regular Season - Week 1). 

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

 

Request Parameters

Parameter Mandatory Description Example(s) 
sportsEventId Yes

If you have a parent sport event’s GN id you can use that to find the sport event(s) that are children of it.

accept Yes

Choose between XML and JSON for the response.

eventStatus No Choose a specific status (scheduled, in_progress, completed or postponed) for the sports event(s). scheduled
in_progress
completed
postponed
eventType No Choose a specific type (e.g. match, league, league_season, phase) for the sports event(s) returned from the call. match
league
league_season
phase
dateFrom No Choose a date (yyyy-mm-dd) for the start of a date range. 2018-01-01
dateTo No Choose a date (yyyy-mm-dd) for the end of a date range. 2018-01-08
sort No  Allows you to sort (base on date) your response in ascending (ASC) or desending (DESC) order. ASC, DESC
skip No  Indicate the number of results to skip in the response.
limit No  Indicate the maximum number of results in the response.
includeParticipants No Allows you to include the Event Participants for the sports event in the repsonse. This is particularly ideal for matches when you want to have the teams competiting, their stats as well as the sports event information (e.g. status, state) all in one call.
includeOrganizations No Takes includeParticipants one step further and allows you to include the Organizations and their informantion (e.g. name) for the included Event Participants that represent teams.
includePersons No Takes includeParticipants one step further and allows you to include the Persons and their informantion (e.g. name) for the included Event Participants that represent persons (e.g. players, officials).
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 data (id and name) for any sportIds in the reponse. 
sportId, venueId
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 event.

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, onsports) of the xid.
type The description of the supplier's id keyspace.
id The supplier's id for the associated entity.
description A description for the event.
type The type of event (e.g. MATCH, LEAGUE_SEASON, CONFERENCE_SEASON, etc.).
scheduled_start_time_utc
The date and time (UTC) when the event starts or started.
end_time The date and time (UTC) when the event ends or ended, if applicable.
status The status (e.g. SCHEDULED, IN_PROGRESS, COMPLETED) of the event.
state This information differs depending on the sport/league but generally includes what you would expect to see in a scorebox for a match (e.g. scoring by team, scoring by period, time of match, period, etc.)
attendance The attendance for the event ("match" type only), if applicable.
sport_id The id for the sport related to the event.
phase_id For "phase" type events only, the id of the phase related to the event.
venue_id The venue id for the event, if applicable.
sports_organization_ids The id for the organization that represents the league or tour related to the event.
parent_sports_event_ids The ids for any parent events for the event. Events are part of a hierarchy with parent and child events.
weather_conditions (if applicable) The weather conditions for an event, if applicable.
temperature_fahrenheit (if applicable) The temperature of the event in fahrenheit, if applicable.
temperature_celsius (if applicable) The temperature of the event in celsius, if applicable.
wind_speed_miles (if applicable) The wind speed for the event in miles, if applicable.
wind_speed_kilometers (if applicable) The wind speed for the event in kilometers, if applicable.
wind_direction (if applicable) The wind direction (e.g. SOUTH) of the event, if applicable.
weather_type (if applicable) The weather type for an event (e.g. CLOUDY), if applicable.
baseball_home_plate_wind_direction (if applicable) For baseball, the wind direction in relation to home plate (e.g. OUT_TO_CENTER), if applicable.

 

Sample

Sample Request

Return all matches for Matchday 5 of the 2018-19 Premier League season. 

Parameters: 

  • sportsEventId: GN0VERGZWJ52ZNQ (represents Matchday 5 of the 2018-19 Premier League season)

 

Sample Response

 

 Return all matches for Matchday 5 of the 2018-19 Premier League season...
<sports_events>
    <sports_event>
        <id>GNC900DJFNZ6TBD</id>
        <meta>
            <update_date>2018-09-27T15:58:01.311Z</update_date>
        </meta>
        <xids>
            <xid>
                <supplier>onsports</supplier>
                <type>event</type>
                <id>17592190537289</id>
            </xid>
            <xid>
                <supplier>infostrada</supplier>
                <type>soccer_match</type>
                <id>2275829</id>
            </xid>
        </xids>
        <description>Manchester City - Fulham</description>
        <type>MATCH</type>
        <start_date_local>2018-09-15</start_date_local>
        <scheduled_start_time_utc>2018-09-15T14:00:00.000Z</scheduled_start_time_utc>
        <end_time>2018-09-15T15:51:41.683Z</end_time>
        <status>COMPLETED</status>
        <state>
            <entry>
                <key>away_score_period_1</key>
                <value>0</value>
            </entry>
            <entry>
                <key>home_formation</key>
                <value>4-3-3</value>
            </entry>
            <entry>
                <key>away_score_period_2</key>
                <value>0</value>
            </entry>
            <entry>
                <key>home_score</key>
                <value>3</value>
            </entry>
            <entry>
                <key>away_formation</key>
                <value>4-3-3</value>
            </entry>
            <entry>
                <key>away_score</key>
                <value>0</value>
            </entry>
            <entry>
                <key>home_score_period_1</key>
                <value>2</value>
            </entry>
            <entry>
                <key>home_score_period_2</key>
                <value>1</value>
            </entry>
        </state>
        <attendance>53307</attendance>
        <sport_id>GNFB17MNF4TH4KM</sport_id>
        <venue_id>GN5S4SGRAMR5ZQQ</venue_id>
        <sports_organization_ids>
            <value>GN98BZGJZVDZDVN</value>
        </sports_organization_ids>
        <parent_sports_event_ids>
            <value>GN3QER8VYBMR3T9</value>
            <value>GNA9YQRKTK2PMAQ</value>
            <value>GND1K9FZ39NAN2W</value>
            <value>GN0VERGZWJ52ZNQ</value>
        </parent_sports_event_ids>
    </sports_event>
    <sports_event>
        <id>GNFY3BT3A3P309F</id>
        <meta>
            <update_date>2018-09-27T15:58:00.826Z</update_date>
        </meta>
        <xids>
            <xid>
                <supplier>onsports</supplier>
                <type>event</type>
                <id>17592190537272</id>
            </xid>
            <xid>
                <supplier>infostrada</supplier>
                <type>soccer_match</type>
                <id>2275828</id>
            </xid>
        </xids>
        <description>Huddersfield Town - Crystal Palace</description>
        <type>MATCH</type>
        <start_date_local>2018-09-15</start_date_local>
        <scheduled_start_time_utc>2018-09-15T14:00:00.000Z</scheduled_start_time_utc>
        <end_time>2018-09-15T15:53:14.113Z</end_time>
        <status>COMPLETED</status>
        <state>
            <entry>
                <key>away_score_period_1</key>
                <value>1</value>
            </entry>
            <entry>
                <key>home_formation</key>
                <value>3-4-3</value>
            </entry>
            <entry>
                <key>away_score_period_2</key>
                <value>0</value>
            </entry>
            <entry>
                <key>home_score</key>
                <value>0</value>
            </entry>
            <entry>
                <key>away_formation</key>
                <value>4-5-1</value>
            </entry>
            <entry>
                <key>away_score</key>
                <value>1</value>
            </entry>
            <entry>
                <key>home_score_period_1</key>
                <value>0</value>
            </entry>
            <entry>
                <key>home_score_period_2</key>
                <value>0</value>
            </entry>
        </state>
        <attendance>23696</attendance>
        <sport_id>GNFB17MNF4TH4KM</sport_id>
        <venue_id>GNDHGPMADAM9GFS</venue_id>
        <sports_organization_ids>
            <value>GN98BZGJZVDZDVN</value>
        </sports_organization_ids>
        <parent_sports_event_ids>
            <value>GN3QER8VYBMR3T9</value>
            <value>GNA9YQRKTK2PMAQ</value>
            <value>GND1K9FZ39NAN2W</value>
            <value>GN0VERGZWJ52ZNQ</value>
        </parent_sports_event_ids>
        <weather_conditions>
            <weather_type>CLOUDY</weather_type>
        </weather_conditions>
    </sports_event>...