Location Today API

Returns today's launches, arrivals, and a deduplicated list of aircraft/pilots that departed from a PureTrack airfield or launch point today. This endpoint is public: no API key, login, subscription, or club membership is required. Normal API rate limits apply.

Endpoint

GET https://puretrack.io/api/locations/{location}/today

The current local calendar day and IANA timezone are determined from the location's coordinates using PureTrack's timezone mapper. If the mapper returns an unknown timezone, UTC is used for both the returned timezone and day bounds. There are no date or timezone overrides.

Example requests

curl -H "Accept: application/json" "https://puretrack.io/api/locations/NZOM/today"
curl -H "Accept: application/json" "https://puretrack.io/api/locations/78969/today"

Response

{
  "location": {"id": 78969, "name": "Example Airfield", "icao": "NZXX"},
  "timezone": "Pacific/Auckland",
  "date": "2026-11-08",
  "start_ts": 1794135600,
  "end_ts": 1794222000,
  "stats": {"launches": 3, "arrivals": 2, "total": 4},
  "departures": [
    {"key": "Y-ZK-ABC", "label": "ZK-ABC", "flying": true, "url": "https://puretrack.io/?k=Y-ZK-ABC"},
    {"key": "Y-ZK-DEF", "label": "ZK-DEF", "flying": false, "url": "https://puretrack.io/?k=Y-ZK-DEF"}
  ],
  "time": 0.0123,
  "success": true,
  "http_code": 200
}

• start_ts is inclusive local midnight and end_ts is exclusive midnight of the next local day, both Unix epoch seconds. Day length can change with daylight saving.
• launches counts flights starting at this location during the day, including flights still airborne.
• arrivals counts flights ending at this location during the day, even if they launched on a previous day or elsewhere.
• total counts distinct flights with either event. A flight launching and arriving here today contributes one to total and one to each event count. Repeated flights by the same aircraft count separately.
• departures contains one entry per tracking key that launched from this location today, not per flight. It includes flights still airborne and return flights, but excludes arrival-only traffic and flights that departed before today's local midnight. Arrival-only flights still contribute to the arrival and total statistics. flying reflects the current PureTrack state; url opens that key on the map. Labels are resolved in a batch.
• Private targets and private tracks are excluded unless the current user's existing permissions allow access. Excluded flights do not contribute to statistics.
• Moving trips and low-pass/touch-and-go event rows are not included. A location without activity returns zero counts and an empty list.

An invalid location parameter returns HTTP 422; a missing or unknown location returns HTTP 404. Tracking and flight detection can be delayed, so this is not an authoritative movement log.

For historical reports, see the Location Take-off & Landing API.