# Generic import Paste the URL of your hosted data to synchronize participants and devices with the event in your RACEMAP account. Import data from multiple online files, also. The generic import checks the format of your hosted data and replies to which parameters are imported. ![Past URLs of online sources to import the participants into Racemap event](https://1672210197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSRNxaH2Ju9Flr7JhJD%2Fuploads%2FoUc8p897lKqN1j6ndEcH%2Fscreenshot-racemap.com-2023.07.12-16_45_31.png?alt=media\&token=43c49d04-89d8-4460-84a9-b05a79bf5362)

Detailed description of errors when import fails for specific entries

{% hint style="success" %} Test the API with your RACEMAP event. Use the sample files. * json sample file: * xml sample file: {% endhint %} ### Format of import data

Field	Description	Sample
`importId`	Required user-defined ID, unique within Racemap event, a new `importID` creates a new participant	`"import_DWBK"` or `"03487"` or `"1sl71kaut2"`
`name`	Name	`"Max"` or `"🔥"` or `"40012"`
`startNumber`	Bib number	`"40012"` or `"🔥"` or `"Max"`
`startTime`	Time in UTC of first possible geolocation, earlier location data is ignored for visualization and leaderboard	`"2022-01-24T15:00:00.000Z"`
`endTime`	Time in UTC of last possible geolocation, later location data is ignored for visualization and leaderboard	`"2022-01-24T23:00:00.000Z"`
`key`	No import, if value of `key` does not belong to Racemap event	`"3Z2GPX"`
`markerColor`	Marker color in visualization, hex code	`"#023d10"`
`tags.age` or `tags.sex`	Attributes to filter participants eg. age group or nation, format	`"35"` or `"male"` or `"Island"`
`times.start`	Timestamp in UTC of start detection, considered in the leaderboard; `startTime` used instead, if import doesn't contain `times.start`	`"2022-01-24T15:25:10.000Z"`
`times.end`	Timestamp in UTC of finish detection, considered in the leaderboard; `endTime` used instead, if import doesn't contain `times.end`	`"2022-01-24T22:53:45.000Z"`
`times.5km` or `times.loop`	Timestamp in UTC of read from split	`"2022-01-24T20:17:24.000Z"`
`device.id`	IMEI of GPS unit or transponder ID	`"4106050246"` or `"RRPing_ZDKAR32"` or `"RRPing_70761"`
`device.class`	Device class	`"Mobile"` or `"Tracker"` or `"Upload"` or `"Transponder"` or `"null"`
`device.type`	Device type	`"GL320-MG"` or `"GL300"` or `"LK106"` or `"active"` or `"passive"` or `"null"`

{% tabs %} {% tab title="json" %} {% code lineNumbers="true" %} ```javascript [ { "importId": "UniqueImportID_0", "name": "Petra Pan Minimal", "startNumber": "A1206", "tags.age": "25", "tags.sex": "w" }, { "importId": "UniqueImportID_1", "name": "Peter Pan With Color", "startNumber": "A1207", "markerColor": "#4d79ff", "tags.age": "35", "tags.sex": "m" }, { "importId": "UniqueImportID_3", "name": "Peter Pan With Tracker and specific type/class", "startNumber": "A1209", "device.class": "Tracker", "device.type": "Gl300", "device.id": "001111112222223" }, { "importId": "UniqueImportID_4", "name": "Peter Pan With Times", "startNumber": "A1210", "times.start": "2020-04-24T14:30:06.708Z", "times.end": "2020-04-24T15:30:06.708Z" }, { "importId": "UniqueImportID_4", "name": "Peter Pan With Start and End Times", "startNumber": "A1210", "startTime": "2020-04-25T14:30:06.708Z", "endTime": "2020-04-25T15:30:06.708Z" } ] ``` {% endcode %} {% endtab %} {% tab title="xml" %}

<root>
  <starters>
    <importId>UniqueImportID_0</importId>
    <name>Petra Pan Minimal</name>
    <startNumber>A1206</startNumber>
    <tags>
       <age>25</age>
       <sex>w</sex>
    </tags>
  </starters>
  <starters>
    <importId>UniqueImportID_1</importId>
    <name>Peter Pan With Color</name>
    <startNumber>A1207</startNumber>
    <markerColor>#4d79ff</markerColor>
    <tags>
      <age>35</age>
     <sex>m</sex>
    </tags>
  </starters>
  <starters>
    <importId>UniqueImportID_2</importId>
    <name>Peter Pan With Tracker</name>
    <startNumber>A1208</startNumber>
    <devices>
      <class>Tracker</class>
      <type>Gl300</type>
      <id>001111112222223</id>
    </devices>
  </starters>
  <starters>
    <importId>UniqueImportID_3</importId>
    <name>Peter Pan With Times</name>
    <startNumber>A1209</startNumber>
    <times>
      <start>2020-04-24T14:30:06.708Z</start>
      <end>2020-04-24T15:30:06.708Z</end>
      <loop>2020-04-24T15:15:06.708Z</loop>
    </times>
  </starters>
  <starters>
    <importId>UniqueImportID_4</importId>
    <name>Peter Pan With Start and End Times</name>
    <startNumber>A1210</startNumber>
    <startTime>2020-04-25T14:30:06.708Z</startTime>
    <endTime>2020-04-25T15:30:06.708Z</endTime>
  </starters>
</root>

{% endtab %} {% endtabs %} ### Filter input by tag You can filter the incoming participants by a single tag category. To achieve this, activate the filtering option using the filter symbol. Subsequently, select the category and the specific tag values to be imported.

{% hint style="info" %} By default, we import every participant who does not have the selected filter category. To prevent this, you must assign a tag to the participant and set the value to `none`, for example. {% endhint %} ### RACE RESULT lists Use predefined lists to import and synchronize participants and devices into Racemap within seconds. {% hint style="info" %} Download templates\ \ [**Download full sample**](https://drive.google.com/uc?id=1LnXjkS0P7A7J0AOTE914Qjaa1n3xwBZi\&export=download) with `importId`, `name`, `startNumber`, `markerColor`, `tags.age`, `device.id`, `device.class`, `device.type`, `times.start`, `times.loop`, `times.finish` : \ \ [**Download minimal sample**](https://drive.google.com/uc?id=1iw1HUnHUy6XXIe_KaWvOfMZcXPK3hn0h\&export=download) with `importId`, `name`, `startNumber`, `markerColor`, `tags.age`, `device.id`, `times.start`, `times.finish` : {% endhint %} **Upload template file** Upload the list template in RACE RESULT, Lists, Import icon

The new "List Template full" is shown under Lists, Participants.

**Activate access** Enable the access to the list in Basic Settings, Access Rights. * Check the "Active" field * Select "List" in Type field * Select the "List Template full" list in Details field * Select JSON * Copy the link

**Past the link** Past the link in RACEMAP, Generic Import field