Ask or search…
K
Links

*/starters, athlete data

API with parameters from participants in Racemap event

Request

URL https://racemap.com/api/events/:eventId/starters Method GET
Sample

Response

Participant object

(*) data protection, parameters provided only for signed-in Racemap account
Field
Description [unit]
Sample
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"
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

Field
Description [unit]
Sample
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"
without import
RACE|RESULT import
[
{
"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",
"listPosition": 0
},
{
"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",
"listPosition": 1
},
{
"manualFinishDuration": 22213000,
"key": "I76F8U",
"keyUsed": false,
"markerColor": "#ffffff",
"startNumber": "03",
"name": "Leupold",
"appId": "eacc3d70-a0fa-44cd-a64b-ce1323aca17d",
"deviceType": "",
"deviceClass": "Upload",
"startTime": null,
"endTime": null,
"eventId": "60a3b443f096f800018add7c",
"updatedAt": "2021-11-03T15:16:25.672Z",
"trackId": "5eac3dca3c3b2dffc3ed4f88",
"times": {},
"tags": {
"age": "40-49",
"sex": "mal",
"club": "VfA end"
},
"integrations": {
"importId": "UniqueImportId_3"
},
"id": "60a3b67914742230ef4a5be2",
"listPosition": 2
},
{
"manualFinishDuration": 25945000,
"key": "6OEZS2",
"keyUsed": false,
"markerColor": "#ffffff",
"startNumber": "04",
"name": " KRad",
"appId": "d2652220-e4d2-4e84-ba23-7a3e7ff17f51",
"deviceType": "",
"deviceClass": "Upload",
"startTime": null,
"endTime": null,
"eventId": "60a3b443f096f800018add7c",
"updatedAt": "2021-11-03T15:09:45.722Z",
"trackId": "5eadb043454eea39f6d016ad",
"times": {},
"tags": {
"age": "30-39",
"sex": "mal",
"club": "VfA end"
},
"integrations": {
"importId": "UniqueImportId_4"
},
"id": "60a3b679147422101b4a5be3",
"listPosition": 3
}
]
[
{
"manualFinishDuration": null,
"keyUsed": true,
"markerColor": "#f2f2f2",
"startNumber": "1",
"name": "Christoph Schroth",
"eventId": "61431c9fd2595a00010f9459",
"appId": "4105637844",
"deviceClass": "Tracker",
"deviceType": "",
"startTime": "2021-09-09T23:00:00.000Z",
"endTime": null,
"key": null,
"integrations": {
"raceresultKey": "1_180472_0"
},
"updatedAt": "2021-11-22T14:34:56.436Z",
"trackId": "6143234182ad4c13bf2d0028",
"times": {},
"tags": {
"age": "Elite M30",
"sex": "m",
"nationality": "GER",
"contest": "Gravel",
"Team": "Mixed",
"Category": "Amateur"
},
"id": "61431cee820e709d29d7ee44",
"listPosition": 0
},
{
"manualFinishDuration": null,
"keyUsed": false,
"markerColor": "#ffffff",
"name": "Norman Rzepka",
"eventId": "61431c9fd2595a00010f9459",
"appId": "868239051000755",
"deviceClass": "Tracker",
"updatedAt": "2021-09-29T12:11:50.438Z",
"trackId": "610956afe4018e5557493ea7",
"tags": {
"age": "30-40",
"sex": "male",
"nationality": "DE"
},
"times": {},
"startNumber": "2",
"id": "6152c1c8620311618ac789fe",
"listPosition": 1
},
{
"manualFinishDuration": null,
"keyUsed": false,
"markerColor": "#f2f2f2",
"startNumber": "2",
"name": "Konrad Treppe",
"eventId": "61431c9fd2595a00010f9459",
"appId": "RRPing_2",
"deviceClass": "TrackPingTransponder",
"deviceType": "Active",
"startTime": "2021-09-09T23:00:00.000Z",
"endTime": null,
"key": "7FMNV1",
"tags": {
"age": "Elite M40",
"sex": "m",
"nationality": "GER",
"contest": "Gravel",
"Team": "Men",
"Category": "Amateur"
},
"integrations": {
"raceresultKey": "2_180472_0"
},
"updatedAt": "2021-11-22T14:34:56.435Z",
"trackId": "5ba900db9193f62fab70120f",
"times": {},
"id": "618ba4412117075dc830d637",
"listPosition": 2
},
{
"manualFinishDuration": null,
"keyUsed": false,
"markerColor": "#ffffff",
"name": "Konrad Treppe",
"eventId": "61431c9fd2595a00010f9459",
"appId": "860599002043107",
"deviceClass": "Tracker",
"updatedAt": "2021-09-29T12:11:57.130Z",
"trackId": "5ae383ba9c86ec3d48c2a91c",
"tags": {
"age": "40-50",
"sex": "male",
"nationality": "DE"
},
"times": {},
"startNumber": "3",
"id": "61544c0d41ae9d2f1c127fcb",
"listPosition": 3
},
{
"manualFinishDuration": null,
"keyUsed": false,
"markerColor": "#f2f2f2",
"startNumber": "3",
"name": "Norman Rzepka",
"eventId": "61431c9fd2595a00010f9459",
"appId": "RRPing_3",
"deviceClass": "TrackPingTransponder",
"deviceType": "Active",
"startTime": "2021-09-09T23:00:00.000Z",
"endTime": null,
"key": "IRSJ0X",
"tags": {
"age": "Elite M30",
"sex": "m",
"nationality": "GER",
"contest": "Gravel",
"Team": "Mixed",
"Category": "Pro"
},
"integrations": {
"raceresultKey": "4_180472_0"
},
"updatedAt": "2021-11-22T14:35:57.077Z",
"trackId": "5ba900dbcbc0c32f9130647c",
"times": {},
"id": "618ba44183d84c9b994fbdce",
"listPosition": 4
}
]