Skip to content
Developer

EventTimingRead

Events6 EndpointsEvent / EventTimingRead

Returns a list of event timing read entries.

GET/api/event/timing_read

Query parameters

idinteger
baseEventstring
timingPointstring
signUpstring
devicestring
rawBibstring
rawChipstring
readTimestring
readTimeMsstringUnix time in milliseconds (device clock corrected by its offset).
sourcestring
externalIdstringId of the read at its source (device sequence number, CSV row), used for idempotency.
statusstring
createdstring
searchStringstringtext to search for in the list
orderFieldNamestringname of the order field
orderFieldSortstringsorting modeAllowed: DESCASC
pageintegerpage of the list
pageSizeintegernumber of entries for each page
withMaxPageNumberstringreturns the number of pages available as a header if this is set

Responses

200Returns a list of EventTimingRead objectsarray<EventTimingRead>

Show fields (19)
  • base_event_idinteger
  • timing_point_idinteger
  • sign_up_idinteger
  • bib_labelstring
  • namestring
  • device_idinteger
  • read_time_msinteger

    Unix time in milliseconds (device clock corrected by its offset).

  • idinteger

    Primary key of the timing read. Internal ID.

  • raw_bibstring

    Bib number as read by the device.

  • raw_chipstring

    Chip ID as read by the device.

  • read_timestring (date-time)

    Time of the read.

  • sourcestring

    Source of the read, for example device or manual entry.

  • external_idstring

    Id of the read at its source (device sequence number, CSV row), used for idempotency.

  • statusstring

    Status of the read, for example matched or unknown.

  • latitudenumber (float)

    Latitude of the read in degrees, if known.

  • longitudenumber (float)

    Longitude of the read in degrees, if known.

  • accuracynumber (float)

    Accuracy of the position in meters.

  • notestring

    Note on the read.

  • createdstring (date-time)

    Time the read was stored.

Request
curl --request GET \
  --url https://your-instance.iw-erp.de/api/event/timing_read \
  --header 'x-iw-jwt-token: <TOKEN>'
Response 200 application/json
[
  {
    "name": "Beispiel",
    "id": 42,
    "base_event_id": 42,
    "timing_point_id": 42,
    "sign_up_id": 42,
    "bib_label": "string",
    "device_id": 42,
    "read_time_ms": 1,
    "raw_bib": "string",
    "raw_chip": "string"
  }
]

Manual read, e.g. typed in at the finish line. Without read_time_ms the server time is used.

POST/api/event/timing_read

Request body application/json

  • base_eventinteger
  • timing_pointinteger
  • bibstring
  • sign_upinteger
  • read_time_msinteger

Responses

200{results: [ReadResult]}

Request
curl --request POST \
  --url https://your-instance.iw-erp.de/api/event/timing_read \
  --header 'content-type: application/json' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --data '
{
  "base_event": 1,
  "timing_point": 1,
  "bib": "string",
  "sign_up": 1,
  "read_time_ms": 1
}
'

Several reads at once, e.g. from an app or an external timing system.

POST/api/event/timing_read/batch

Request body application/json

  • base_eventinteger
  • readsarray<object>

Responses

200{results: [ReadResult]}

Request
curl --request POST \
  --url https://your-instance.iw-erp.de/api/event/timing_read/batch \
  --header 'content-type: application/json' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --data '
{
  "base_event": 1,
  "reads": [
    {}
  ]
}
'

Correction of a read: status (e.g. IGNORED), assigned sign up or timing point.

PUT/api/event/timing_read/{identifier}

Path parameters

identifierrequiredstring

Request body application/json

  • statusstring
  • sign_upinteger
  • timing_pointinteger

Responses

200The updated readEventTimingRead

Show fields (19)
  • base_event_idinteger
  • timing_point_idinteger
  • sign_up_idinteger
  • bib_labelstring
  • namestring
  • device_idinteger
  • read_time_msinteger

    Unix time in milliseconds (device clock corrected by its offset).

  • idinteger

    Primary key of the timing read. Internal ID.

  • raw_bibstring

    Bib number as read by the device.

  • raw_chipstring

    Chip ID as read by the device.

  • read_timestring (date-time)

    Time of the read.

  • sourcestring

    Source of the read, for example device or manual entry.

  • external_idstring

    Id of the read at its source (device sequence number, CSV row), used for idempotency.

  • statusstring

    Status of the read, for example matched or unknown.

  • latitudenumber (float)

    Latitude of the read in degrees, if known.

  • longitudenumber (float)

    Longitude of the read in degrees, if known.

  • accuracynumber (float)

    Accuracy of the position in meters.

  • notestring

    Note on the read.

  • createdstring (date-time)

    Time the read was stored.

Request
curl --request PUT \
  --url https://your-instance.iw-erp.de/api/event/timing_read/42 \
  --header 'content-type: application/json' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --data '
{
  "status": "string",
  "sign_up": 1,
  "timing_point": 1
}
'
Response 200 application/json
{
  "name": "Beispiel",
  "id": 42,
  "base_event_id": 42,
  "timing_point_id": 42,
  "sign_up_id": 42,
  "bib_label": "string",
  "device_id": 42,
  "read_time_ms": 1,
  "raw_bib": "string",
  "raw_chip": "string"
}

Correction of a read: status (e.g. IGNORED), assigned sign up or timing point.

PATCH/api/event/timing_read/{identifier}

Path parameters

identifierrequiredstring

Request body application/json

  • statusstring
  • sign_upinteger
  • timing_pointinteger

Responses

200The updated readEventTimingRead

Show fields (19)
  • base_event_idinteger
  • timing_point_idinteger
  • sign_up_idinteger
  • bib_labelstring
  • namestring
  • device_idinteger
  • read_time_msinteger

    Unix time in milliseconds (device clock corrected by its offset).

  • idinteger

    Primary key of the timing read. Internal ID.

  • raw_bibstring

    Bib number as read by the device.

  • raw_chipstring

    Chip ID as read by the device.

  • read_timestring (date-time)

    Time of the read.

  • sourcestring

    Source of the read, for example device or manual entry.

  • external_idstring

    Id of the read at its source (device sequence number, CSV row), used for idempotency.

  • statusstring

    Status of the read, for example matched or unknown.

  • latitudenumber (float)

    Latitude of the read in degrees, if known.

  • longitudenumber (float)

    Longitude of the read in degrees, if known.

  • accuracynumber (float)

    Accuracy of the position in meters.

  • notestring

    Note on the read.

  • createdstring (date-time)

    Time the read was stored.

Request
curl --request PATCH \
  --url https://your-instance.iw-erp.de/api/event/timing_read/42 \
  --header 'content-type: application/json' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --data '
{
  "status": "string",
  "sign_up": 1,
  "timing_point": 1
}
'
Response 200 application/json
{
  "name": "Beispiel",
  "id": 42,
  "base_event_id": 42,
  "timing_point_id": 42,
  "sign_up_id": 42,
  "bib_label": "string",
  "device_id": 42,
  "read_time_ms": 1,
  "raw_bib": "string",
  "raw_chip": "string"
}

CSV import (multipart field "file"), see docs/event/STARTNUMMERN_ZEITMESSUNG.md.

POST/api/event/base_event/{identifier}/timing/import_csv

Path parameters

identifierrequiredstring

Request body multipart/form-data

  • filestring (binary)

Responses

200{results, created, duplicates, unassigned, errors}

Request
curl --request POST \
  --url https://your-instance.iw-erp.de/api/event/base_event/42/timing/import_csv \
  --header 'content-type: multipart/form-data' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --form file='@datei.pdf'