Get pilot totals

Fetch a linked pilot’s cumulative flight totals.

GET /v1/pilot-totals?pilot_id=PILOT_ID

Required scope: pilot-totals.

Request

curl

curl -X GET \
  "https://api.skyden.app/functions/v1/api/v1/pilot-totals?pilot_id=52b00948-12cd-4d06-ac29-027641d59ef0" \
  -H "Authorization: Bearer YOUR_API_KEY"

JavaScript

const pilotId = "52b00948-12cd-4d06-ac29-027641d59ef0";
const res = await fetch(
  `https://api.skyden.app/functions/v1/api/v1/pilot-totals?pilot_id=${pilotId}`,
  { headers: { Authorization: `Bearer ${process.env.SKYDEN_API_KEY}` } },
);
const { data } = await res.json();

Python

import os, requests

pilot_id = "52b00948-12cd-4d06-ac29-027641d59ef0"
res = requests.get(
    "https://api.skyden.app/functions/v1/api/v1/pilot-totals",
    headers={"Authorization": f"Bearer {os.environ['SKYDEN_API_KEY']}"},
    params={"pilot_id": pilot_id},
)
data = res.json()["data"]

Response

200 OK

{
  "data": {
    "pilot_id": "52b00948-12cd-4d06-ac29-027641d59ef0",
    "last_updated": "2026-04-21T06:22:12.127Z",
    "totals": {
      "total_flight_time_minutes": 7342,
      "pic_minutes": 6765,
      "sic_minutes": 577,
      "dual_minutes": 0,
      "instructor_minutes": 2432,
      "cross_country_minutes": 7342,
      "night_minutes": 4036,
      "ifr_minutes": 7189,
      "actual_instrument_minutes": 7189,
      "simulated_instrument_minutes": 0,
      "single_engine_minutes": 0,
      "multi_engine_minutes": 7342,
      "multi_pilot_minutes": 7342,
      "simulator_minutes": 1305
    },
    "landings": {
      "total_day": 20,
      "total_night": 14
    },
    "flight_count": 80,
    "last_flight_date": "2026-04-13T00:00:00.000Z"
  },
  "meta": {
    "api_version": "v1",
    "request_id": "req_03284a58"
  }
}

Freshness

Totals are refreshed every ~5 minutes. last_updated reflects the most recent aggregation, not the pilot’s most recent flight. A flight logged in Skyden may take up to 5 minutes to appear here. A freshly-linked pilot is computed live on the first call, so you get real totals immediately after POST /v1/link without waiting for the next refresh.

Errors specific to this endpoint

Code	Status	Meaning
PILOT_NOT_FOUND	404	Pilot not linked (never linked, or previously disconnected)
INSUFFICIENT_SCOPE	403	Your API key doesn’t have the pilot-totals scope

See Errors for the full list of common error codes.

Field reference

All time values are in minutes (integer).

Field	Description
total_flight_time_minutes	Total flight time
pic_minutes	Pilot in Command
sic_minutes	Second in Command
dual_minutes	Dual instruction received
instructor_minutes	Time as flight instructor
cross_country_minutes	Cross-country flight time
night_minutes	Night flight time
ifr_minutes	Total IFR time (actual + simulated)
actual_instrument_minutes	Actual instrument conditions
simulated_instrument_minutes	Simulated instrument (hood/foggles)
single_engine_minutes	Single-engine aircraft
multi_engine_minutes	Multi-engine aircraft
multi_pilot_minutes	Multi-pilot operations
simulator_minutes	Flight simulator / training device
landings.total_day	Total day landings
landings.total_night	Total night landings
flight_count	Total number of flights
last_flight_date	Date of most recent flight, serialized as an ISO 8601 timestamp at midnight UTC (e.g. 2026-04-13T00:00:00.000Z). null for a pilot with no flights on record.
last_updated	When Skyden last aggregated this pilot’s totals (≤ 5 min old for cached reads, or the current time for just-linked pilots computed live).