» RACEMAPContactLoginUpdates
Search…
Documentation
Provide live tracking
Data APIs for live geodata
*/distance and locations
*/current, location data
*/times, reads and raw data
*/ranks, ranking and results
*/starters, athlete data
Map settings
Import participant data
Export data from Racemap
Hardware for live tracking
Predictive tracking with reads from timing system
Powered By GitBook
*/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"
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
1
[
2
{
3
"manualFinishDuration": null,
4
"key": "3Z2GPX",
5
"keyUsed": true,
6
"markerColor": "#ffffff",
7
"startNumber": "01",
8
"name": "Konrad",
9
"appId": "453cc844-fd1e-4026-976d-ddf05c4dc757",
10
"deviceType": "android|11|samsung SM-M315F|3.24.12",
11
"deviceClass": "Mobile",
12
"startTime": "2020-04-25T06:14:00.000Z",
13
"endTime": "2020-09-25T19:45:00.000Z",
14
"eventId": "60a3b443f096f800018add7c",
15
"updatedAt": "2021-11-03T15:12:14.454Z",
16
"trackId": "6040a02f46406c763600655b",
17
"times": {},
18
"tags": {
19
"age": "30-39",
20
"sex": "mal",
21
"club": "VfA end"
22
},
23
"integrations": {
24
"importId": "UniqueImportId_1"
25
},
26
"id": "60a3b6791474227ee54a5bdf",
27
"listPosition": 0
28
},
29
{
30
"manualFinishDuration": null,
31
"key": "K84N2S",
32
"keyUsed": false,
33
"markerColor": "#ffffff",
34
"startNumber": "02",
35
"name": "Jörg",
36
"appId": "e6921eff-0fba-41b1-aea0-258c202d2e96",
37
"deviceType": "",
38
"deviceClass": "Upload",
39
"startTime": "2020-04-25T06:14:00.000Z",
40
"endTime": "2020-09-25T21:59:00.000Z",
41
"eventId": "60a3b443f096f800018add7c",
42
"updatedAt": "2021-11-03T15:09:35.285Z",
43
"trackId": "5ea88f8e106f5f2d9919c859",
44
"times": {},
45
"tags": {
46
"age": "40-49",
47
"sex": "mal",
48
"club": "VfA end"
49
},
50
"integrations": {
51
"importId": "UniqueImportId_2"
52
},
53
"id": "60a3b679147422b72a4a5be0",
54
"listPosition": 1
55
},
56
{
57
"manualFinishDuration": 22213000,
58
"key": "I76F8U",
59
"keyUsed": false,
60
"markerColor": "#ffffff",
61
"startNumber": "03",
62
"name": "Leupold",
63
"appId": "eacc3d70-a0fa-44cd-a64b-ce1323aca17d",
64
"deviceType": "",
65
"deviceClass": "Upload",
66
"startTime": null,
67
"endTime": null,
68
"eventId": "60a3b443f096f800018add7c",
69
"updatedAt": "2021-11-03T15:16:25.672Z",
70
"trackId": "5eac3dca3c3b2dffc3ed4f88",
71
"times": {},
72
"tags": {
73
"age": "40-49",
74
"sex": "mal",
75
"club": "VfA end"
76
},
77
"integrations": {
78
"importId": "UniqueImportId_3"
79
},
80
"id": "60a3b67914742230ef4a5be2",
81
"listPosition": 2
82
},
83
{
84
"manualFinishDuration": 25945000,
85
"key": "6OEZS2",
86
"keyUsed": false,
87
"markerColor": "#ffffff",
88
"startNumber": "04",
89
"name": " KRad",
90
"appId": "d2652220-e4d2-4e84-ba23-7a3e7ff17f51",
91
"deviceType": "",
92
"deviceClass": "Upload",
93
"startTime": null,
94
"endTime": null,
95
"eventId": "60a3b443f096f800018add7c",
96
"updatedAt": "2021-11-03T15:09:45.722Z",
97
"trackId": "5eadb043454eea39f6d016ad",
98
"times": {},
99
"tags": {
100
"age": "30-39",
101
"sex": "mal",
102
"club": "VfA end"
103
},
104
"integrations": {
105
"importId": "UniqueImportId_4"
106
},
107
"id": "60a3b679147422101b4a5be3",
108
"listPosition": 3
109
}
110
]
Copied!
1
[
2
{
3
"manualFinishDuration": null,
4
"keyUsed": true,
5
"markerColor": "#f2f2f2",
6
"startNumber": "1",
7
"name": "Christoph Schroth",
8
"eventId": "61431c9fd2595a00010f9459",
9
"appId": "4105637844",
10
"deviceClass": "Tracker",
11
"deviceType": "",
12
"startTime": "2021-09-09T23:00:00.000Z",
13
"endTime": null,
14
"key": null,
15
"integrations": {
16
"raceresultKey": "1_180472_0"
17
},
18
"updatedAt": "2021-11-22T14:34:56.436Z",
19
"trackId": "6143234182ad4c13bf2d0028",
20
"times": {},
21
"tags": {
22
"age": "Elite M30",
23
"sex": "m",
24
"nationality": "GER",
25
"contest": "Gravel",
26
"Team": "Mixed",
27
"Category": "Amateur"
28
},
29
"id": "61431cee820e709d29d7ee44",
30
"listPosition": 0
31
},
32
{
33
"manualFinishDuration": null,
34
"keyUsed": false,
35
"markerColor": "#ffffff",
36
"name": "Norman Rzepka",
37
"eventId": "61431c9fd2595a00010f9459",
38
"appId": "868239051000755",
39
"deviceClass": "Tracker",
40
"updatedAt": "2021-09-29T12:11:50.438Z",
41
"trackId": "610956afe4018e5557493ea7",
42
"tags": {
43
"age": "30-40",
44
"sex": "male",
45
"nationality": "DE"
46
},
47
"times": {},
48
"startNumber": "2",
49
"id": "6152c1c8620311618ac789fe",
50
"listPosition": 1
51
},
52
{
53
"manualFinishDuration": null,
54
"keyUsed": false,
55
"markerColor": "#f2f2f2",
56
"startNumber": "2",
57
"name": "Konrad Treppe",
58
"eventId": "61431c9fd2595a00010f9459",
59
"appId": "RRPing_2",
60
"deviceClass": "TrackPingTransponder",
61
"deviceType": "Active",
62
"startTime": "2021-09-09T23:00:00.000Z",
63
"endTime": null,
64
"key": "7FMNV1",
65
"tags": {
66
"age": "Elite M40",
67
"sex": "m",
68
"nationality": "GER",
69
"contest": "Gravel",
70
"Team": "Men",
71
"Category": "Amateur"
72
},
73
"integrations": {
74
"raceresultKey": "2_180472_0"
75
},
76
"updatedAt": "2021-11-22T14:34:56.435Z",
77
"trackId": "5ba900db9193f62fab70120f",
78
"times": {},
79
"id": "618ba4412117075dc830d637",
80
"listPosition": 2
81
},
82
{
83
"manualFinishDuration": null,
84
"keyUsed": false,
85
"markerColor": "#ffffff",
86
"name": "Konrad Treppe",
87
"eventId": "61431c9fd2595a00010f9459",
88
"appId": "860599002043107",
89
"deviceClass": "Tracker",
90
"updatedAt": "2021-09-29T12:11:57.130Z",
91
"trackId": "5ae383ba9c86ec3d48c2a91c",
92
"tags": {
93
"age": "40-50",
94
"sex": "male",
95
"nationality": "DE"
96
},
97
"times": {},
98
"startNumber": "3",
99
"id": "61544c0d41ae9d2f1c127fcb",
100
"listPosition": 3
101
},
102
{
103
"manualFinishDuration": null,
104
"keyUsed": false,
105
"markerColor": "#f2f2f2",
106
"startNumber": "3",
107
"name": "Norman Rzepka",
108
"eventId": "61431c9fd2595a00010f9459",
109
"appId": "RRPing_3",
110
"deviceClass": "TrackPingTransponder",
111
"deviceType": "Active",
112
"startTime": "2021-09-09T23:00:00.000Z",
113
"endTime": null,
114
"key": "IRSJ0X",
115
"tags": {
116
"age": "Elite M30",
117
"sex": "m",
118
"nationality": "GER",
119
"contest": "Gravel",
120
"Team": "Mixed",
121
"Category": "Pro"
122
},
123
"integrations": {
124
"raceresultKey": "4_180472_0"
125
},
126
"updatedAt": "2021-11-22T14:35:57.077Z",
127
"trackId": "5ba900dbcbc0c32f9130647c",
128
"times": {},
129
"id": "618ba44183d84c9b994fbdce",
130
"listPosition": 4
131
}
132
]
Copied!
Previous
*/ranks, ranking and results
Next
Map settings
Last modified 2mo ago
Copy link
Contents
Request
Response