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
    },
    "rating_breakdown": {
      "sep_land": 1240,
      "mep_land": 560,
      "set_land": 180,
      "type_a320": 8200,
      "type_b737_300_900": 3600
    },
    "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
rating_breakdown	Per-rating flight time, in minutes. Object keyed by airplane class rating and type rating identifiers. Keys with zero minutes are omitted, and the object is {} for pilots with no airplane hours. See Rating breakdown below.
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).

Rating breakdown

rating_breakdown splits total airplane flight time by rating, in minutes. Keys are Skyden’s stable rating identifiers; values are minutes.

Two kinds of keys can appear:

• Class ratings (seven possible keys, listed below).
• Type ratings, prefixed with type_ (e.g. type_a320, type_b737_300_900). The full list of type-rating keys is published through the rating dictionary endpoint when your API key has the rating-dictionary scope.

Class rating keys

Key	Class rating
sep_land	Single-Engine Piston (Land)
sep_sea	Single-Engine Piston (Sea)
set_land	Single-Engine Turbine (Land)
set_sea	Single-Engine Turbine (Sea)
mep_land	Multi-Engine Piston (Land)
mep_sea	Multi-Engine Piston (Sea)
tmg	Touring Motor Glider

Notes

• Helicopter and sailplane hours are not included in rating_breakdown.
• Minutes merge flight records with the pilot’s manually entered starting totals (e.g. hours imported from a previous logbook).
• Keys with zero minutes are omitted. The object is {} for pilots with no airplane hours.
• Sum of all values will usually be lower than totals.total_flight_time_minutes (helicopter, sailplane, and other categories are excluded here but counted in the top-level totals).