The Official
Website of the
International
Sailing Federation

isaf.com

ISAF XRR Download Service

Technical Description (Download)

The data download service allows external sources to perform look-up queries on Sailor Biography and Event data.  The Sailor biography query allows for automation of the process of validating Sailor IDs and classification groupings.  Performing look-ups on events can be used to set-up an overall regatta in a 3rd party software package.

Sailor Details Look-up

The first method is to use a query parameterised with personal details:

http://datafeed.sailing.org/query?type=Person&FamilyName=[familyname]&GivenName=[givenname]&NOC=[nationcode]

Using this method the type parameter is required to specify a search for Person elements, of the other parameters at least one is mandatory, they are specified as follows:

  • FamilyName: Family name for the sailor(s), uses partial strings, non-case-sensitive
  • GivenName: Given name for the sailors(s), uses partial strings, non-case-sensitive
  • NOC: 3 letter nation code for the sailor search, uses complete strings only (3 characters), non-case-sensitive

for example:

http://datafeed.sailing.org/query?type=Person&FamilyName=smit&GivenName=Dav&NOC=GBR

Results are in ascending order by FamilyName, then GivenName, then IFPersonID.

Sailor ID Look-up

The second method available to perform this action is as follows:

http://datafeed.sailing.org/query?type=Person&IFPersonID=[sailorID1,sailorID2]

Where the type parameter is used to specify that the query is looking for Person elements and IFPersonID contains either a single Sailor ID or a comma-separated list of Sailor IDs, for example:

http://datafeed.sailing.org/query?type=Person&IFPersonID=USATS15,GBRMI2,GBRTT27,GBRIT9

Where the response has Person elements missing this indicates that those IDs are invalid.  Results are in ascending order by FamilyName, then GivenName, then IFPersonID.

Event Details Look-up

The first method available for requesting regatta details is as follows:

http://datafeed.sailing.org/query?type=Event&Date=[date]&Title=[title]

Here the type parameter specifies a look-up on Event elements, of the other parameters at least one is required, they are specified as follows:

  • Date: In the format YYYY-MM-DD, cannot be submitted as a partial string, specifies that the results will include only regattas that are running during the specified date (started on or before and ending on or after)
  • Title: refers to the name of the regatta, minimum of 4 characters, accepts partial strings, non-case-sensitive

For example:

http://datafeed.sailing.org/query?type=Event&Date=2012-05-05&Title=champ

Results are in ascending order by StartDate then Title.

Event ID Look-up

The second method available for requesting regatta details is as follows:

http://datafeed.sailing.org/query?type=Event&IFEventID=[eventID1,eventID2]

The type parameter specifies that the query refers to Event elements with the IFEventID parameter taking either a single event id or a comma separated list of event ids. For example:

http://datafeed.sailing.org/query?type=Event&IFEventID=IFRGT-15505,IFRGT-15560,IFRGT-15509

Results are in ascending order by StartDate then Title.

© 2014 Copyright ISAF/ISAF UK Ltd. All Rights Reserved Privacy & Cookies delivered by Sotic powered by OpenText WSM