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>