positions/get_border_crossings.php

Last modified by YellowFox_RD on 2026/05/13 14:01

This function returns all border crossings with driver authentication of your vehicles.

Description

GET  positions/get_border_crossings.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=YYYY-MM-DDTHH:MM:SS+HH:mm&end=YYYY-MM-DDTHH:MM:SS+HH:mm

Parameter

parameterdescriptiontypehintmandatory
companyRTI company keystring yes
vehicleRTI vehicle keystringYou have to set vehicle, group or import.(yes)
groupRTI group keystring(yes)
importRTI import keystring(yes)
startstart of query date rangedatestringFormat: ISO 8601 (YYYY-MM-DDTHH:MM:SS+HH:mm)yes
endend of query date rangedatestringFormat: ISO 8601 (YYYY-MM-DDTHH:MM:SS+HH:mm)

yes

employeeNumberemployee numberstring no
offsetThe request returns 1000 data records at max. Use offset to access the next block.intdefault: 0no

Output

string is being returned. Will return "ERROR:description" on error.

JSON

You can find a JSON schema description here.

{
   "_date": {
       "query_date": "2026-05-11T08:33:10+02:00",
       "start": "2026-04-04T02:00:00+02:00",
       "end": "2026-05-04T23:15:00+02:00"
    },
   "_links": {
       "next": {
           "href": null
        }
    },
   "has_more": false,
   "items": [
        {
           "gpsDate": "2026-04-21T07:22:25+02:00",
           "unit": {
               "licensePlate": "FTL YF 123",
               "rtiIdent": "U123"
            },
           "driver": {
               "name": "Max Mustermann",
               "key": "123456789",
               "employeeNumber": "1"
            },
           "from": {
               "countryCode": "D"
            },
           "to": {
               "countryCode": "NL"
            },
           "position": {
               "text": "NL-9057 Jelsum Aldlânsdyk",
               "lat": 53.234474,
               "lon": 5.7904854             
            }
        }
    ]
}

Example calls

Query for single vehicle

https://map.yellowfox.de/rti/positions/get_border_crossings.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=2022-09-22T13:23:00%2B00:00:00&end=2022-09-25T13:23:00%2B00:00:00

Query with RTI ident

https://map.yellowfox.de/rti/positions/get_border_crossings.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&start=2022-09-22T13:23:00%2B00:00:00&end=2022-09-25T13:23:00%2B00:00:00