Search API for tags, serials or competitor ids

Overview

Search public flights by serial / MAC, device tag, or competitor tag, and get back a paginated list. The term is matched anywhere in those fields (case-insensitive contains). Each result carries the headline figures a list view needs: the flight id, serial, tag, apogee, the main chart thumbnail, the flight page link and the CSV log download link.

Only publicly visible flights are returned, the same set shown on the public flight pages.

Endpoint

Parameters

Request

curl "https://www.altimetercloud.com/api/flight_search/?q=MY-NANO&limit=50&page=1"
curl "https://www.altimetercloud.com/api/flight_search/?q=1051-dbec"

Response

{
  "success": true,
  "query": "MY-NANO",
  "competitor_search": true,
  "page": 1,
  "limit": 100,
  "total": 2,
  "count": 2,
  "flights": [
    {
      "id": 1234,
      "url": "https://www.altimetercloud.com/flights/1234/",
      "csv_url": "https://www.altimetercloud.com/flightdata/4/1234.csv",
      "mac": "1051-dbec-747c",
      "tag": "MY-NANO",
      "competitor_tag": "C-07",
      "device": "nanov1",
      "firmware": "1.52",
      "revision": "4",
      "apogee": 246.4,
      "apogee_time": 5210,
      "uploaddate": "10/06/26-14:22:01",
      "uploadstamp": 1781453721,
      "thumbnail": "https://www.altimetercloud.com/flightdata/4/1234.webp",
      "thumbnail_large": "https://www.altimetercloud.com/flightdata/4/1234_l.webp"
    }
  ]
}

Top-level fields

Result fields

Competitor tag search

The competitor_search flag reports whether competitor tag was part of the search. Competitor tag is read from the flight log at upload time; if your install stores it as a flight column, this endpoint searches and returns it automatically. If not, search covers serial/MAC and device tag only, and competitor_search is false. To pull a single flight's competitor tag regardless, use the Flight Info endpoint, which reads it from the log directly.

API Playground

Enter a term (serial, tag or competitor) and click Run to search.