*/starters, athlete data
API with parameters from participants in Racemap event
Request
URL https://racemap.com/api/events/:eventId/starters
Method GET
Sample
with RACE|RESULT API to synchronize participants https://racemap.com/api/events/61431c9fd2595a00010f9459/starters
without API to import participants https://racemap.com/api/events/60a3b443f096f800018add7c/starters
Response
Participant object
(*) data protection, parameters provided only for signed-in Racemap account
manualFinishDuration
Manually edited duration [ms] to reach the finish
22213000
or null
key
*
key
assigned to participant
"K84N2S"
keyUsed
Indicator if key used in tracking app or to upload activity
true
or false
markerColor
Color of dot in tracking map, hex code
"#ffffff"
startNumber
Bib number of participant
"02"
name
Name
"KRad"
deviceType
Type of used device, eg. type of GPS tracker or smartphone
"GT560"
deviceClass
Class of used device
Mobile
, Upload
, Tracker
or Transponder
startTime
Timestamp of the first location in UTC
"2021-09-09T23:00:00.000Z"
or null
endTime
Timestamp of last location in UTC
"2021-09-10T03:04:07.020Z"
or null
eventId
Unique Racemap ID of event
"60a3b443f096f800018add7c"
appId
*
Unique Racemap ID of installed tracking app or IMEI of tracker or transponder ID
"4105637864"
updatedAt
Timestamp of latest update participant's parameters in UTC
"2021-12-17T11:22:07.598Z"
trackId
*
Unique Racemap ID of geolocations
"5ba900db9193f62fab70120f"
id
Unique Racemap ID of participant
"61bc72291190558210a76d97"
gpxUrl
URL to download the device's recorded track
"http://racemap.com/api/starters/61bc72291190558210a76d97/gpx"
listPosition
Position in API
2
times
Object with received timestamps from generic API in UTC
tags
Object with optional attributes to filter participants eg. age group or nation, format "tag": "value"
"age": "40-49", "sex": "mal", "club": "VfA end"
integrations
Object with addtional 3rd party information of participant
Integrations object
importId
User-defined ID with imported participant data, Generic API (importId
) or RACE|RESULT API (Id
)
"UniqueImportId_3"
or "2"
or "null"
if no importId exists
genericImportKey
Unique Racemap ID, from import with Generic API, not the same as importId
"622a1e78f5b3110001c8dd75_Z7csQ5_UniqueImportID_2"
raceresultKey
Unique Racemap ID, from import with RACE|RESULT API, not the same as importId
"2_180472_0"
[
{
"manualFinishDuration": null,
"key": "3Z2GPX",
"keyUsed": true,
"markerColor": "#ffffff",
"startNumber": "01",
"name": "Konrad",
"appId": "453cc844-fd1e-4026-976d-ddf05c4dc757",
"deviceType": "android|11|samsung SM-M315F|3.24.12",
"deviceClass": "Mobile",
"startTime": "2020-04-25T06:14:00.000Z",
"endTime": "2020-09-25T19:45:00.000Z",
"eventId": "60a3b443f096f800018add7c",
"updatedAt": "2021-11-03T15:12:14.454Z",
"trackId": "6040a02f46406c763600655b",
"times": {},
"tags": {
"age": "30-39",
"sex": "mal",
"club": "VfA end"
},
"integrations": {
"importId": "UniqueImportId_1"
},
"id": "60a3b6791474227ee54a5bdf",
"gpxUrl": "http://racemap.com/api/starters/60a3b6791474227ee54a5bdf/gpx",
"listPosition": 0,
"deviceGpsFix": false
},
{
"manualFinishDuration": null,
"key": "K84N2S",
"keyUsed": false,
"markerColor": "#ffffff",
"startNumber": "02",
"name": "Jörg",
"appId": "e6921eff-0fba-41b1-aea0-258c202d2e96",
"deviceType": "",
"deviceClass": "Upload",
"startTime": "2020-04-25T06:14:00.000Z",
"endTime": "2020-09-25T21:59:00.000Z",
"eventId": "60a3b443f096f800018add7c",
"updatedAt": "2021-11-03T15:09:35.285Z",
"trackId": "5ea88f8e106f5f2d9919c859",
"times": {},
"tags": {
"age": "40-49",
"sex": "mal",
"club": "VfA end"
},
"integrations": {
"importId": "UniqueImportId_2"
},
"id": "60a3b679147422b72a4a5be0",
"gpxUrl": "http://racemap.com/api/starters/60a3b679147422b72a4a5be0/gpx",
"listPosition": 1,
"deviceGpsFix": false
}
]
Last updated