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

FieldDescription [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

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

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

Last updated