Get device passings

Gets the list of passings from the timing device for continuous querying scenarios.

Retrieves passing data from a specific timing device, combining date range queries with session-based continuity. This endpoint lets you efficiently resume data collection from a specific point and automatically handles transitions between sessions.

GET https://api.runonrufus.com/v0/passings/device2/{deviceid}

Notes

• If token_session and last are provided, the system will automatically resume data retrieval from that point.

• If a newer session exists for the device, the endpoint will automatically jump to it and resume from the beginning.

• This endpoint is ideal for continuous querying scenarios, ensuring efficiency and simplicity when collecting live passing data during events.

Path Parameters

Name	Type	Description
deviceid*	String	Id of the device.

Query Parameters

Name	Type	Description
from	Date	Date object containing the timestamp information of the first passing of the device to retrieve. Format: YYYY-MM-DDTHH:mm:ss.sssZ
to	Date	Date object containing the timestamp information of the last passing of the device to retrieve. Format: YYYY-MM-DDTHH:mm:ss.sssZ
token_session	String	Session token from which you want to resume retrieving passings
last	Int	The last num_passing processed within the specified session
page	Int	Page number of the list of passing to retrieve. Each page can contain up to 5000 passings.

Headers

Name	Type	Description
api_key*	String	Account api key with READ or READ_WRITE access type.

200: OK Returns the list of passings from the session.

{
  "description": "Success",
  "deviceid": "4284AD86F432F7EC04D5C275A87F2E586D75A2EFAD3C6CE42988ACE247219FFF",
  "session_used": "sess-abc123",
  "session_label": "Marathon Split KM10",
  "resumed_from": 42,
  "passings": [
    {
      "bib": "101",
      "timestamp": "2025-04-03T22:56:21.000Z",
      "num_passing": 43,
      "latitude": "40.7128",
      "longitude": "-74.0060",
      "chip": "1234567890ABCDEF"
    },
    {
      "bib": "102",
      "timestamp": "2025-04-03T22:56:23.000Z",
      "num_passing": 44,
      "latitude": "40.7128",
      "longitude": "-74.0060",
      "chip": "1234567890ABCDE0"
    }
  ]
}