*/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

This endpoint is public. Anyone can read the participant list without signing in, as long as the event's visibility is Open, Listed, or Unlisted. For Draft or Archived events the response is an empty list for anonymous callers.

Fields marked with (*) (e.g. key, appId, trackId) are personal data and are only included for signed-in Racemap accounts that may edit the event.

Response

Participant object

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"
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

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

[
  {
    "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
  }
]

RACE|RESULT import

[
  {
    "integrations": {
      "importId": "1",
      "raceresultKey": "1_180472_1",
      "messagingToken": null
    },
    "appId": "4105637844",
    "deviceType": null,
    "deviceClass": "Tracker",
    "manualFinishDuration": null,
    "keyUsed": false,
    "markerColor": "#f2f2f2",
    "startNumber": "1",
    "name": "Christoph Schroth",
    "eventId": "61431c9fd2595a00010f9459",
    "tags": {
      "age": "Elite M30",
      "sex": "m",
      "nationality": "GER",
      "status": "DNS",
      "contest": "Gravel",
      "Team": "Mixed",
      "Category": "Amateur"
    },
    "times": {
      "start": "2021-09-09T22:00:00.000Z"
    },
    "updatedAt": "2023-08-10T09:16:15.066Z",
    "trackId": "6143234182ad4c13bf2d0028",
    "endTime": null,
    "startTime": "2021-09-09T22:00:00.000Z",
    "key": "6WLWTR",
    "id": "631857aed4074c7d42cb4945",
    "gpxUrl": "http://racemap.com/api/starters/631857aed4074c7d42cb4945/gpx",
    "listPosition": 0,
    "deviceGpsFix": false,
    "deviceId": null
  },
  {
    "integrations": {
      "messagingToken": null,
      "importId": "5",
      "raceresultKey": "5_180472_1"
    },
    "appId": "860665002484665",
    "deviceType": null,
    "deviceClass": "Tracker",
    "manualFinishDuration": null,
    "keyUsed": false,
    "markerColor": "#04b404",
    "startNumber": "4",
    "name": "Karl Wolffgang",
    "eventId": "61431c9fd2595a00010f9459",
    "tags": {
      "age": "Elite M30",
      "sex": "m",
      "nationality": "GER",
      "contest": "MTB",
      "Team": "Men",
      "Category": "Amateur"
    },
    "times": {
      "start": "2021-09-09T22:00:00.000Z"
    },
    "updatedAt": "2022-09-10T05:02:02.295Z",
    "trackId": "61431f892237cfdd853da2d9",
    "endTime": null,
    "startTime": "2021-09-09T22:00:00.000Z",
    "id": "631857aeb520f243962f832d",
    "gpxUrl": "http://racemap.com/api/starters/631857aeb520f243962f832d/gpx",
    "listPosition": 4,
    "deviceGpsFix": false,
    "deviceId": null
  }
]