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>