API - Skater ID Lookup

Look up a skater's ID.

URL

Type URL
XML http://speedskatingresults.com/api/xml/skater_lookup.php
JSON http://speedskatingresults.com/api/json/skater_lookup.php

Parameters

Name Description
familyname

Skater's family name (optional). A starting substring may be specified instead of the entire name.

givenname

Skater's given name (optional). A starting substring may be specified instead of the entire name.

country

A three character IOC country code (optional).

gender

The skater's gender: m (male) or f (female) (optional).

While all four parameters are optional, a value must be specified for at least one of them.

XML

Element Description
skaters The list of skaters matching the search criteria. A maximum of 10 skaters will be returned.
skaterA skater matching the search criteria
idThe skater's ID
familynameThe skater's family name
givennameThe skater's given name
countryIOC country code
genderm (male) or f (female)
categoryThe skater's age category as of the current date. If the skater's date of birth is not in the SpeedskatingResults.com database, this element will not be present.

Example

API Query: http://speedskatingresults.com/api/xml/skater_lookup?familyname=cod&country=CAN

<?xml version="1.0" encoding="utf-8" ?>
<skaters>
  <skater>
    <id>1714</id>
    <familyname>Coder</familyname>
    <givenname>Amanda</givenname>
    <country>CAN</country>
    <gender>f</gender>
    <category>N3</category>
  </skater>
  <skater>
    <id>538</id>
    <familyname>Coder</familyname>
    <givenname>Stacie</givenname>
    <country>CAN</country>
    <gender>f</gender>
    <category>SA</category>
  </skater>
  <skater>
    <id>36227</id>
    <familyname>Coderre</familyname>
    <givenname>Paul</givenname>
    <country>CAN</country>
    <gender>m</gender>
  </skater>
</skaters>

JSON

Key Description
skaters The list of skaters matching the search criteria. A maximum of 10 skaters will be returned.
idThe skater's ID
familynameThe skater's family name
givennameThe skater's given name
countryIOC country code
genderm (male) or f (female)
categoryThe skater's age category as of the current date. If the skater's date of birth is not in the SpeedskatingResults.com database, this key will not be present.

Example

API Query: http://speedskatingresults.com/api/json/skater_lookup?familyname=cod&country=CAN

{
  "skaters":[
    {"id":1714, "familyname":"Coder", "givenname":"Amanda", "country":"CAN", "gender":"f", "category":"SA"},
    {"id":538, "familyname":"Coder", "givenname":"Stacie", "country":"CAN", "gender":"f", "category":"SA"},
    {"id":36227, "familyname":"Coderre", "givenname":"Paul", "country":"CAN", "gender":"m", "category":"B1"}
  ]
}
SpeedskatingResults.com on Facebook