Search API for tags, serials or competitor ids

Public — no authentication required Paginated search

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

GET https://www.altimetercloud.com/api/flight_search/ Parameters: q, limit, page

Parameters

Parameter	Type	Description
`q`	string	Search term, at least 2 characters. Matched against serial/MAC, device tag and competitor tag
`limit`	integer	Results per page. Default 100, maximum 200
`page`	integer	Page number, starting at 1. Default 1

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

✓ Results

{
  "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

Field	Type	Description
`query`	string	The search term that was run
`competitor_search`	boolean	Whether competitor tag was included in the search (see note below)
`page` / `limit`	integer	The page returned and the page size
`total`	integer	Total matching flights across all pages. Divide by `limit` to get the page count
`count`	integer	Number of flights on this page
`flights`	array	The page of results

Result fields

Field	Type	Description
`id` / `url`	integer / string	Cloud flight id and its public flight page
`csv_url`	string	Direct download link for the raw CSV log
`mac`	string	Device serial / MAC
`tag` / `competitor_tag`	string	Device tag and competitor tag
`device` / `firmware` / `revision`	string	Model, firmware version and hardware revision
`apogee`	float	Peak altitude in metres
`apogee_time`	integer	Time of apogee in milliseconds
`uploaddate` / `uploadstamp`	string / integer	Upload date string and unix timestamp
`thumbnail` / `thumbnail_large`	string	Main chart image (metres), small and large

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.

Search term

https://www.altimetercloud.com/api/flight_search/

Cloud API

Introduction CSV Verification Flight Info Upload API Search