Find Person by Person ID

gns-api/persons

API to return the person(s) for the specific Person ID.

Persons represent...

players
officials (if applicable)

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

Request Parameters

Parameter	Mandatory	Description
personId	Yes	If you already have a person’s GN id, you can use that to find the person.
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 persons, this is limited to "names".

Response Body

Response	Description
id	Unique Gracenote id for the person.
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, tms) of the xid.
type	The description of the supplier's id keyspace.
id	The supplier's id for the associated entity.
name	The name of the person.
type	The type of name for the person (e.g. FIRST, LAST).
value	The value for the type of name for the person (e.g. Crosby)
birthdate	The birthdate (e,g, 1987-03-31) for the person.
height_inches	The height of the person in inches.
height_millimetres	The height of the person in millimetres.
weight_pounds	The weight of the person in pounds.
weight_grams	The weight of the person in grams.
gender	The gender of the person.
birth_place
city	The city for the birth place of the person.
state	The state for the birth place of the person, if applicable.
country	The country for the birth place of the person.

Sample

Sample Request

personId: GNEFSHGKYS5E8T7

Sample Response

PERSON (player):
 
 <persons>
        <person>
            <id>GNEFSHGKYS5E8T7</id>
            <meta>
                <update_date>2018-02-28T07:24:32.847Z</update_date>
            </meta>
            <xids>
                <xid>
                    <supplier>sportsdirect</supplier>
                    <type>xml</type>
                    <id>/sport/basketball/player:774924</id>
                </xid>
                <xid>
                    <supplier>infostrada</supplier>
                    <type>general_person</type>
                    <id>1619837</id>
                </xid>
            </xids>
            <names>
                <name>
                    <type>FIRST</type>
                    <value>Lonzo</value>
                </name>
                <name>
                    <type>LAST</type>
                    <value>Ball</value>
                </name>
            </names>
            <birthdate>1997-10-27</birthdate>
            <height_inches>78</height_inches>
            <weight_pounds>190</weight_pounds>
            <height_millimetres>1981</height_millimetres>
            <weight_grams>86182</weight_grams>
            <gender>MALE</gender>
            <birth_place>
                <city>Chino Hills</city>
                <state>California</state>
                <country>USA</country>
            </birth_place>
        </person>
    </persons>

version 4 as of 3 weeks ago by mark.taylor