{"openapi":"3.1.0","info":{"title":"Aviation & Airport Operations Intelligence API","version":"1.0.0","description":"Normalize flight schedules, analyze delay patterns, calculate connection risk, track diversions, look up aircraft registrations, parse maintenance logs, check document expiry, estimate flight emissions, analyze airport ground time, and build operations reports—using caller-supplied operational data plus optional key-free OpenSky aircraft metadata. Paid with x402 exact USDC on Base. No account is required.","contact":{"email":"support@brainiac.software"},"x-guidance":"BRAINIAC.software is a pay-per-call API for software agents. No account or API key is required.\nPayment uses the x402 protocol with exact USDC on Base (chain id 8453). Each POST operation has a fixed USD price.\nHow to call an operation:\n1. POST a JSON body matching the operation's requestBody schema to the operation path. Include an Idempotency-Key header (64 hex characters, 32 random bytes).\n2. If you have not paid, the server responds 402 with payment requirements in the body. Pay the exact amount to the payTo address on Base.\n3. Retry the identical request with the same Idempotency-Key and add a payment-signature header containing the x402 payment payload. On success (200) the operation result is returned.\n4. Reuse the same Idempotency-Key only for retries of the same operation and request body; it will not be charged twice.\nAll outputs are compliance prechecks, drafts, or data lookups for human review. They are not official determinations, legal advice, identity confirmation, or certified filings. Verify time-sensitive or official data with the cited source before acting."},"servers":[{"url":"https://www.brainiac.software"}],"paths":{"/api/v1/aviation-intelligence/flight-schedule-normalize":{"post":{"operationId":"normalize_flight_schedules","summary":"Normalize flight schedules","description":"Normalize caller-supplied flight schedule fields and compute delay/block times when actual times are present. Paid flight tracking is not used.","tags":["aviation-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80}},"required":["fileBase64"],"additionalProperties":false},"files":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80}},"required":["fileBase64"],"additionalProperties":false}},"flights":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"flightNumber":{"type":"string","maxLength":20},"airline":{"type":"string","maxLength":120},"airlineIata":{"type":"string","maxLength":8},"origin":{"type":"string","maxLength":8},"destination":{"type":"string","maxLength":8},"scheduledDepartureAt":{"type":"string","maxLength":40},"scheduledArrivalAt":{"type":"string","maxLength":40},"actualDepartureAt":{"type":"string","maxLength":40},"actualArrivalAt":{"type":"string","maxLength":40},"status":{"type":"string","maxLength":80},"aircraftRegistration":{"type":"string","maxLength":20},"aircraftType":{"type":"string","maxLength":40},"distanceKm":{"type":"number","minimum":0,"maximum":40000},"seats":{"type":"number","minimum":0,"maximum":1000},"passengers":{"type":"number","minimum":0,"maximum":1000},"fuelBurnKg":{"type":"number","minimum":0,"maximum":1000000},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"diversions":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"flightId":{"type":"string","maxLength":80},"flightNumber":{"type":"string","maxLength":20},"plannedDestination":{"type":"string","maxLength":8},"diversionAirport":{"type":"string","maxLength":8},"divertedAt":{"type":"string","maxLength":40},"reason":{"type":"string","maxLength":200},"resumedAt":{"type":"string","maxLength":40},"finalDestination":{"type":"string","maxLength":8},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"registrations":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"registration":{"type":"string","maxLength":20},"icao24":{"type":"string","maxLength":12},"aircraftType":{"type":"string","maxLength":40},"manufacturer":{"type":"string","maxLength":120},"model":{"type":"string","maxLength":120},"operator":{"type":"string","maxLength":160},"owner":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"serialNumber":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"maintenanceLogs":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"registration":{"type":"string","maxLength":20},"at":{"type":"string","maxLength":40},"taskCode":{"type":"string","maxLength":80},"description":{"type":"string","maxLength":400},"hours":{"type":"number","minimum":0,"maximum":100000},"cycles":{"type":"number","minimum":0,"maximum":1000000},"status":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"documents":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"subject":{"type":"string","maxLength":160},"documentType":{"type":"string","maxLength":80},"registration":{"type":"string","maxLength":20},"issuedAt":{"type":"string","maxLength":40},"expiresAt":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"groundTimes":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"airport":{"type":"string","maxLength":8},"flightNumber":{"type":"string","maxLength":20},"registration":{"type":"string","maxLength":20},"arrivalAt":{"type":"string","maxLength":40},"departureAt":{"type":"string","maxLength":40},"scheduledGroundMinutes":{"type":"number","minimum":0,"maximum":10000},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"emissionFactors":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"aircraftType":{"type":"string","maxLength":40},"kgCo2PerKm":{"type":"number","minimum":0,"maximum":1000},"kgCo2PerPassengerKm":{"type":"number","minimum":0,"maximum":10},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"connections":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"inboundFlightId":{"type":"string","maxLength":80},"outboundFlightId":{"type":"string","maxLength":80},"airport":{"type":"string","maxLength":8},"minimumConnectMinutes":{"type":"number","minimum":0,"maximum":1440},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"openSky":{"type":"object","properties":{"icao24":{"type":"string","minLength":1,"maxLength":12}},"required":["icao24"],"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"expiryWarningDays":{"type":"number","minimum":0,"maximum":3650}},"additionalProperties":false},"example":{"asOf":"2026-11-04T21:00:00.000Z","flights":[{"id":"F1","flightNumber":"BA100","airline":"British Airways","airlineIata":"BA","origin":"LHR","destination":"JFK","scheduledDepartureAt":"2026-11-01T10:00:00.000Z","scheduledArrivalAt":"2026-11-01T18:00:00.000Z","actualDepartureAt":"2026-11-01T10:40:00.000Z","actualArrivalAt":"2026-11-01T18:50:00.000Z","aircraftType":"B777","aircraftRegistration":"G-STBA","source":"Caller-supplied"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"flightCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"flightNumber":{"type":"string"},"airline":{"type":"string"},"airlineIata":{"type":"string"},"origin":{"type":"string"},"destination":{"type":"string"},"scheduledDepartureAt":{"type":"string"},"scheduledArrivalAt":{"type":"string"},"actualDepartureAt":{"type":"string"},"actualArrivalAt":{"type":"string"},"status":{"type":"string"},"aircraftRegistration":{"type":"string"},"aircraftType":{"type":"string"},"departureDelayMinutes":{"type":"number"},"departureDelayMinutesSupplied":{"type":"boolean"},"arrivalDelayMinutes":{"type":"number"},"arrivalDelayMinutesSupplied":{"type":"boolean"},"scheduledBlockMinutes":{"type":"number"},"scheduledBlockMinutesSupplied":{"type":"boolean"},"actualBlockMinutes":{"type":"number"},"actualBlockMinutesSupplied":{"type":"boolean"},"source":{"type":"string"},"paidFlightTrackingUsed":{"type":"boolean"}},"additionalProperties":true}},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"paidFlightTrackingUsed":{"type":"boolean"},"authenticatedAirlineSystemUsed":{"type":"boolean"},"openSkyFetched":{"type":"boolean"},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"normalized","flightCount":1,"items":[{"id":"F1","flightNumber":"BA100","airline":"British Airways","airlineIata":"BA","origin":"LHR","destination":"JFK","scheduledDepartureAt":"2026-11-01T10:00:00.000Z","scheduledArrivalAt":"2026-11-01T18:00:00.000Z","actualDepartureAt":"2026-11-01T10:40:00.000Z","actualArrivalAt":"2026-11-01T18:50:00.000Z","status":"delayed","aircraftRegistration":"G-STBA","aircraftType":"B777","departureDelayMinutes":40,"departureDelayMinutesSupplied":true,"arrivalDelayMinutes":50,"arrivalDelayMinutesSupplied":true,"scheduledBlockMinutes":480,"scheduledBlockMinutesSupplied":true,"actualBlockMinutes":490,"actualBlockMinutesSupplied":true,"source":"Caller-supplied","paidFlightTrackingUsed":false}],"paidProviderUsed":false,"apiKeyRequired":false,"paidFlightTrackingUsed":false,"authenticatedAirlineSystemUsed":false,"openSkyFetched":false,"findings":[],"limitations":["Flight schedules, diversions, registrations, maintenance logs, documents, ground times, emission factors, and connections are copied only from labeled fields supplied by the caller, or from key-free OpenSky aircraft metadata when openSky.icao24 is requested.","No paid flight-tracking API or authenticated airline system is used and no API key is required.","Delay, connection, diversion, ground-time, and emissions results use only supplied times/distances/factors (or a small disclosed public-style CO2 factor table when no factor or fuel burn is supplied).","Document expiry checks compare caller-supplied expiry dates to asOf only. Regulatory compliance is not determined.","Operations reports aggregate only sections for which records were supplied or optionally fetched."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]}}},"/api/v1/aviation-intelligence/flight-delay-pattern-analyze":{"post":{"operationId":"analyze_flight_delay_patterns","summary":"Analyze flight delay patterns","description":"Aggregate delay statistics by flight number/route from caller-supplied scheduled and actual times.","tags":["aviation-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80}},"required":["fileBase64"],"additionalProperties":false},"files":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80}},"required":["fileBase64"],"additionalProperties":false}},"flights":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"flightNumber":{"type":"string","maxLength":20},"airline":{"type":"string","maxLength":120},"airlineIata":{"type":"string","maxLength":8},"origin":{"type":"string","maxLength":8},"destination":{"type":"string","maxLength":8},"scheduledDepartureAt":{"type":"string","maxLength":40},"scheduledArrivalAt":{"type":"string","maxLength":40},"actualDepartureAt":{"type":"string","maxLength":40},"actualArrivalAt":{"type":"string","maxLength":40},"status":{"type":"string","maxLength":80},"aircraftRegistration":{"type":"string","maxLength":20},"aircraftType":{"type":"string","maxLength":40},"distanceKm":{"type":"number","minimum":0,"maximum":40000},"seats":{"type":"number","minimum":0,"maximum":1000},"passengers":{"type":"number","minimum":0,"maximum":1000},"fuelBurnKg":{"type":"number","minimum":0,"maximum":1000000},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"diversions":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"flightId":{"type":"string","maxLength":80},"flightNumber":{"type":"string","maxLength":20},"plannedDestination":{"type":"string","maxLength":8},"diversionAirport":{"type":"string","maxLength":8},"divertedAt":{"type":"string","maxLength":40},"reason":{"type":"string","maxLength":200},"resumedAt":{"type":"string","maxLength":40},"finalDestination":{"type":"string","maxLength":8},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"registrations":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"registration":{"type":"string","maxLength":20},"icao24":{"type":"string","maxLength":12},"aircraftType":{"type":"string","maxLength":40},"manufacturer":{"type":"string","maxLength":120},"model":{"type":"string","maxLength":120},"operator":{"type":"string","maxLength":160},"owner":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"serialNumber":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"maintenanceLogs":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"registration":{"type":"string","maxLength":20},"at":{"type":"string","maxLength":40},"taskCode":{"type":"string","maxLength":80},"description":{"type":"string","maxLength":400},"hours":{"type":"number","minimum":0,"maximum":100000},"cycles":{"type":"number","minimum":0,"maximum":1000000},"status":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"documents":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"subject":{"type":"string","maxLength":160},"documentType":{"type":"string","maxLength":80},"registration":{"type":"string","maxLength":20},"issuedAt":{"type":"string","maxLength":40},"expiresAt":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"groundTimes":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"airport":{"type":"string","maxLength":8},"flightNumber":{"type":"string","maxLength":20},"registration":{"type":"string","maxLength":20},"arrivalAt":{"type":"string","maxLength":40},"departureAt":{"type":"string","maxLength":40},"scheduledGroundMinutes":{"type":"number","minimum":0,"maximum":10000},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"emissionFactors":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"aircraftType":{"type":"string","maxLength":40},"kgCo2PerKm":{"type":"number","minimum":0,"maximum":1000},"kgCo2PerPassengerKm":{"type":"number","minimum":0,"maximum":10},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"connections":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"inboundFlightId":{"type":"string","maxLength":80},"outboundFlightId":{"type":"string","maxLength":80},"airport":{"type":"string","maxLength":8},"minimumConnectMinutes":{"type":"number","minimum":0,"maximum":1440},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"openSky":{"type":"object","properties":{"icao24":{"type":"string","minLength":1,"maxLength":12}},"required":["icao24"],"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"expiryWarningDays":{"type":"number","minimum":0,"maximum":3650}},"additionalProperties":false},"example":{"asOf":"2026-11-04T21:00:00.000Z","flights":[{"id":"F1","flightNumber":"BA100","origin":"LHR","destination":"JFK","scheduledDepartureAt":"2026-11-01T10:00:00.000Z","scheduledArrivalAt":"2026-11-01T18:00:00.000Z","actualDepartureAt":"2026-11-01T10:40:00.000Z","actualArrivalAt":"2026-11-01T18:50:00.000Z","source":"Caller-supplied"},{"id":"F2","flightNumber":"BA100","origin":"LHR","destination":"JFK","scheduledDepartureAt":"2026-11-02T10:00:00.000Z","scheduledArrivalAt":"2026-11-02T18:00:00.000Z","actualDepartureAt":"2026-11-02T10:20:00.000Z","actualArrivalAt":"2026-11-02T18:25:00.000Z","source":"Caller-supplied"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"patternCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"airline":{"type":"string"},"route":{"type":"string"},"sampleCount":{"type":"number"},"averageDelayMinutes":{"type":"number"},"medianDelayMinutes":{"type":"number"},"maxDelayMinutes":{"type":"number"},"onTimeCount":{"type":"number"},"lateCount":{"type":"number"},"onTimePct":{"type":"number"},"paidFlightTrackingUsed":{"type":"boolean"}},"additionalProperties":true}},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"paidFlightTrackingUsed":{"type":"boolean"},"authenticatedAirlineSystemUsed":{"type":"boolean"},"openSkyFetched":{"type":"boolean"},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"analyzed","patternCount":1,"items":[{"key":"BA100|LHR-JFK","airline":"","route":"LHR-JFK","sampleCount":2,"averageDelayMinutes":37.5,"medianDelayMinutes":50,"maxDelayMinutes":50,"onTimeCount":0,"lateCount":2,"onTimePct":0,"paidFlightTrackingUsed":false}],"paidProviderUsed":false,"apiKeyRequired":false,"paidFlightTrackingUsed":false,"authenticatedAirlineSystemUsed":false,"openSkyFetched":false,"findings":[],"limitations":["Flight schedules, diversions, registrations, maintenance logs, documents, ground times, emission factors, and connections are copied only from labeled fields supplied by the caller, or from key-free OpenSky aircraft metadata when openSky.icao24 is requested.","No paid flight-tracking API or authenticated airline system is used and no API key is required.","Delay, connection, diversion, ground-time, and emissions results use only supplied times/distances/factors (or a small disclosed public-style CO2 factor table when no factor or fuel burn is supplied).","Document expiry checks compare caller-supplied expiry dates to asOf only. Regulatory compliance is not determined.","Operations reports aggregate only sections for which records were supplied or optionally fetched."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/aviation-intelligence/airport-connection-risk-calculate":{"post":{"operationId":"calculate_airport_connection_risk","summary":"Calculate airport connection risk","description":"Calculate connection slack and risk from inbound/outbound caller-supplied flight times and minimum connect minutes.","tags":["aviation-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80}},"required":["fileBase64"],"additionalProperties":false},"files":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80}},"required":["fileBase64"],"additionalProperties":false}},"flights":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"flightNumber":{"type":"string","maxLength":20},"airline":{"type":"string","maxLength":120},"airlineIata":{"type":"string","maxLength":8},"origin":{"type":"string","maxLength":8},"destination":{"type":"string","maxLength":8},"scheduledDepartureAt":{"type":"string","maxLength":40},"scheduledArrivalAt":{"type":"string","maxLength":40},"actualDepartureAt":{"type":"string","maxLength":40},"actualArrivalAt":{"type":"string","maxLength":40},"status":{"type":"string","maxLength":80},"aircraftRegistration":{"type":"string","maxLength":20},"aircraftType":{"type":"string","maxLength":40},"distanceKm":{"type":"number","minimum":0,"maximum":40000},"seats":{"type":"number","minimum":0,"maximum":1000},"passengers":{"type":"number","minimum":0,"maximum":1000},"fuelBurnKg":{"type":"number","minimum":0,"maximum":1000000},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"diversions":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"flightId":{"type":"string","maxLength":80},"flightNumber":{"type":"string","maxLength":20},"plannedDestination":{"type":"string","maxLength":8},"diversionAirport":{"type":"string","maxLength":8},"divertedAt":{"type":"string","maxLength":40},"reason":{"type":"string","maxLength":200},"resumedAt":{"type":"string","maxLength":40},"finalDestination":{"type":"string","maxLength":8},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"registrations":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"registration":{"type":"string","maxLength":20},"icao24":{"type":"string","maxLength":12},"aircraftType":{"type":"string","maxLength":40},"manufacturer":{"type":"string","maxLength":120},"model":{"type":"string","maxLength":120},"operator":{"type":"string","maxLength":160},"owner":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"serialNumber":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"maintenanceLogs":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"registration":{"type":"string","maxLength":20},"at":{"type":"string","maxLength":40},"taskCode":{"type":"string","maxLength":80},"description":{"type":"string","maxLength":400},"hours":{"type":"number","minimum":0,"maximum":100000},"cycles":{"type":"number","minimum":0,"maximum":1000000},"status":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"documents":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"subject":{"type":"string","maxLength":160},"documentType":{"type":"string","maxLength":80},"registration":{"type":"string","maxLength":20},"issuedAt":{"type":"string","maxLength":40},"expiresAt":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"groundTimes":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"airport":{"type":"string","maxLength":8},"flightNumber":{"type":"string","maxLength":20},"registration":{"type":"string","maxLength":20},"arrivalAt":{"type":"string","maxLength":40},"departureAt":{"type":"string","maxLength":40},"scheduledGroundMinutes":{"type":"number","minimum":0,"maximum":10000},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"emissionFactors":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"aircraftType":{"type":"string","maxLength":40},"kgCo2PerKm":{"type":"number","minimum":0,"maximum":1000},"kgCo2PerPassengerKm":{"type":"number","minimum":0,"maximum":10},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"connections":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"inboundFlightId":{"type":"string","maxLength":80},"outboundFlightId":{"type":"string","maxLength":80},"airport":{"type":"string","maxLength":8},"minimumConnectMinutes":{"type":"number","minimum":0,"maximum":1440},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"openSky":{"type":"object","properties":{"icao24":{"type":"string","minLength":1,"maxLength":12}},"required":["icao24"],"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"expiryWarningDays":{"type":"number","minimum":0,"maximum":3650}},"additionalProperties":false},"example":{"asOf":"2026-11-04T21:00:00.000Z","flights":[{"id":"F1","flightNumber":"BA100","origin":"LHR","destination":"JFK","scheduledArrivalAt":"2026-11-01T18:00:00.000Z","actualArrivalAt":"2026-11-01T18:50:00.000Z","source":"Caller-supplied"},{"id":"F2","flightNumber":"BA117","origin":"JFK","destination":"LHR","scheduledDepartureAt":"2026-11-01T20:00:00.000Z","actualDepartureAt":"2026-11-01T20:10:00.000Z","source":"Caller-supplied"}],"connections":[{"id":"C1","inboundFlightId":"F1","outboundFlightId":"F2","airport":"JFK","minimumConnectMinutes":90,"source":"Caller-supplied"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"connectionCount":{"type":"number"},"highRiskCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"airport":{"type":"string"},"inboundFlightId":{"type":"string"},"outboundFlightId":{"type":"string"},"inboundFlightNumber":{"type":"string"},"outboundFlightNumber":{"type":"string"},"availableConnectMinutes":{"type":"number"},"minimumConnectMinutes":{"type":"number"},"slackMinutes":{"type":"number"},"risk":{"type":"string"},"source":{"type":"string"},"paidFlightTrackingUsed":{"type":"boolean"}},"additionalProperties":true}},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"paidFlightTrackingUsed":{"type":"boolean"},"authenticatedAirlineSystemUsed":{"type":"boolean"},"openSkyFetched":{"type":"boolean"},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"calculated","connectionCount":1,"highRiskCount":1,"items":[{"id":"C1","airport":"JFK","inboundFlightId":"F1","outboundFlightId":"F2","inboundFlightNumber":"BA100","outboundFlightNumber":"BA117","availableConnectMinutes":80,"minimumConnectMinutes":90,"slackMinutes":-10,"risk":"missed","source":"Caller-supplied","paidFlightTrackingUsed":false}],"paidProviderUsed":false,"apiKeyRequired":false,"paidFlightTrackingUsed":false,"authenticatedAirlineSystemUsed":false,"openSkyFetched":false,"findings":[{"kind":"conflict","code":"connection_risk","subject":"C1","detail":"Connection slack -10 minutes is missed."}],"limitations":["Flight schedules, diversions, registrations, maintenance logs, documents, ground times, emission factors, and connections are copied only from labeled fields supplied by the caller, or from key-free OpenSky aircraft metadata when openSky.icao24 is requested.","No paid flight-tracking API or authenticated airline system is used and no API key is required.","Delay, connection, diversion, ground-time, and emissions results use only supplied times/distances/factors (or a small disclosed public-style CO2 factor table when no factor or fuel burn is supplied).","Document expiry checks compare caller-supplied expiry dates to asOf only. Regulatory compliance is not determined.","Operations reports aggregate only sections for which records were supplied or optionally fetched."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/aviation-intelligence/flight-diversion-event-track":{"post":{"operationId":"track_flight_diversion_events","summary":"Track flight diversion events","description":"Normalize caller-supplied diversion events and durations. Live paid tracking feeds are not queried.","tags":["aviation-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80}},"required":["fileBase64"],"additionalProperties":false},"files":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80}},"required":["fileBase64"],"additionalProperties":false}},"flights":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"flightNumber":{"type":"string","maxLength":20},"airline":{"type":"string","maxLength":120},"airlineIata":{"type":"string","maxLength":8},"origin":{"type":"string","maxLength":8},"destination":{"type":"string","maxLength":8},"scheduledDepartureAt":{"type":"string","maxLength":40},"scheduledArrivalAt":{"type":"string","maxLength":40},"actualDepartureAt":{"type":"string","maxLength":40},"actualArrivalAt":{"type":"string","maxLength":40},"status":{"type":"string","maxLength":80},"aircraftRegistration":{"type":"string","maxLength":20},"aircraftType":{"type":"string","maxLength":40},"distanceKm":{"type":"number","minimum":0,"maximum":40000},"seats":{"type":"number","minimum":0,"maximum":1000},"passengers":{"type":"number","minimum":0,"maximum":1000},"fuelBurnKg":{"type":"number","minimum":0,"maximum":1000000},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"diversions":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"flightId":{"type":"string","maxLength":80},"flightNumber":{"type":"string","maxLength":20},"plannedDestination":{"type":"string","maxLength":8},"diversionAirport":{"type":"string","maxLength":8},"divertedAt":{"type":"string","maxLength":40},"reason":{"type":"string","maxLength":200},"resumedAt":{"type":"string","maxLength":40},"finalDestination":{"type":"string","maxLength":8},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"registrations":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"registration":{"type":"string","maxLength":20},"icao24":{"type":"string","maxLength":12},"aircraftType":{"type":"string","maxLength":40},"manufacturer":{"type":"string","maxLength":120},"model":{"type":"string","maxLength":120},"operator":{"type":"string","maxLength":160},"owner":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"serialNumber":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"maintenanceLogs":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"registration":{"type":"string","maxLength":20},"at":{"type":"string","maxLength":40},"taskCode":{"type":"string","maxLength":80},"description":{"type":"string","maxLength":400},"hours":{"type":"number","minimum":0,"maximum":100000},"cycles":{"type":"number","minimum":0,"maximum":1000000},"status":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"documents":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"subject":{"type":"string","maxLength":160},"documentType":{"type":"string","maxLength":80},"registration":{"type":"string","maxLength":20},"issuedAt":{"type":"string","maxLength":40},"expiresAt":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"groundTimes":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"airport":{"type":"string","maxLength":8},"flightNumber":{"type":"string","maxLength":20},"registration":{"type":"string","maxLength":20},"arrivalAt":{"type":"string","maxLength":40},"departureAt":{"type":"string","maxLength":40},"scheduledGroundMinutes":{"type":"number","minimum":0,"maximum":10000},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"emissionFactors":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"aircraftType":{"type":"string","maxLength":40},"kgCo2PerKm":{"type":"number","minimum":0,"maximum":1000},"kgCo2PerPassengerKm":{"type":"number","minimum":0,"maximum":10},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"connections":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"inboundFlightId":{"type":"string","maxLength":80},"outboundFlightId":{"type":"string","maxLength":80},"airport":{"type":"string","maxLength":8},"minimumConnectMinutes":{"type":"number","minimum":0,"maximum":1440},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"openSky":{"type":"object","properties":{"icao24":{"type":"string","minLength":1,"maxLength":12}},"required":["icao24"],"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"expiryWarningDays":{"type":"number","minimum":0,"maximum":3650}},"additionalProperties":false},"example":{"asOf":"2026-11-04T21:00:00.000Z","diversions":[{"id":"D1","flightNumber":"BA100","plannedDestination":"JFK","diversionAirport":"BOS","divertedAt":"2026-11-01T16:00:00.000Z","reason":"weather","resumedAt":"2026-11-01T19:00:00.000Z","finalDestination":"JFK","source":"Caller-supplied"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"eventCount":{"type":"number"},"activeCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"flightId":{"type":"string"},"flightNumber":{"type":"string"},"plannedDestination":{"type":"string"},"diversionAirport":{"type":"string"},"divertedAt":{"type":"string"},"reason":{"type":"string"},"resumedAt":{"type":"string"},"finalDestination":{"type":"string"},"diversionDurationMinutes":{"type":"number"},"diversionDurationMinutesSupplied":{"type":"boolean"},"active":{"type":"boolean"},"source":{"type":"string"},"paidFlightTrackingUsed":{"type":"boolean"}},"additionalProperties":true}},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"paidFlightTrackingUsed":{"type":"boolean"},"authenticatedAirlineSystemUsed":{"type":"boolean"},"openSkyFetched":{"type":"boolean"},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"tracked","eventCount":1,"activeCount":0,"items":[{"id":"D1","flightId":"","flightNumber":"BA100","plannedDestination":"JFK","diversionAirport":"BOS","divertedAt":"2026-11-01T16:00:00.000Z","reason":"weather","resumedAt":"2026-11-01T19:00:00.000Z","finalDestination":"JFK","diversionDurationMinutes":180,"diversionDurationMinutesSupplied":true,"active":false,"source":"Caller-supplied","paidFlightTrackingUsed":false}],"paidProviderUsed":false,"apiKeyRequired":false,"paidFlightTrackingUsed":false,"authenticatedAirlineSystemUsed":false,"openSkyFetched":false,"findings":[],"limitations":["Flight schedules, diversions, registrations, maintenance logs, documents, ground times, emission factors, and connections are copied only from labeled fields supplied by the caller, or from key-free OpenSky aircraft metadata when openSky.icao24 is requested.","No paid flight-tracking API or authenticated airline system is used and no API key is required.","Delay, connection, diversion, ground-time, and emissions results use only supplied times/distances/factors (or a small disclosed public-style CO2 factor table when no factor or fuel burn is supplied).","Document expiry checks compare caller-supplied expiry dates to asOf only. Regulatory compliance is not determined.","Operations reports aggregate only sections for which records were supplied or optionally fetched."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]}}},"/api/v1/aviation-intelligence/aircraft-registration-lookup":{"post":{"operationId":"look_up_aircraft_registrations","summary":"Look up aircraft registrations","description":"Normalize caller-supplied aircraft registration records, optionally enriched with key-free OpenSky aircraft metadata when openSky.icao24 is requested.","tags":["aviation-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80}},"required":["fileBase64"],"additionalProperties":false},"files":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80}},"required":["fileBase64"],"additionalProperties":false}},"flights":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"flightNumber":{"type":"string","maxLength":20},"airline":{"type":"string","maxLength":120},"airlineIata":{"type":"string","maxLength":8},"origin":{"type":"string","maxLength":8},"destination":{"type":"string","maxLength":8},"scheduledDepartureAt":{"type":"string","maxLength":40},"scheduledArrivalAt":{"type":"string","maxLength":40},"actualDepartureAt":{"type":"string","maxLength":40},"actualArrivalAt":{"type":"string","maxLength":40},"status":{"type":"string","maxLength":80},"aircraftRegistration":{"type":"string","maxLength":20},"aircraftType":{"type":"string","maxLength":40},"distanceKm":{"type":"number","minimum":0,"maximum":40000},"seats":{"type":"number","minimum":0,"maximum":1000},"passengers":{"type":"number","minimum":0,"maximum":1000},"fuelBurnKg":{"type":"number","minimum":0,"maximum":1000000},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"diversions":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"flightId":{"type":"string","maxLength":80},"flightNumber":{"type":"string","maxLength":20},"plannedDestination":{"type":"string","maxLength":8},"diversionAirport":{"type":"string","maxLength":8},"divertedAt":{"type":"string","maxLength":40},"reason":{"type":"string","maxLength":200},"resumedAt":{"type":"string","maxLength":40},"finalDestination":{"type":"string","maxLength":8},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"registrations":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"registration":{"type":"string","maxLength":20},"icao24":{"type":"string","maxLength":12},"aircraftType":{"type":"string","maxLength":40},"manufacturer":{"type":"string","maxLength":120},"model":{"type":"string","maxLength":120},"operator":{"type":"string","maxLength":160},"owner":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"serialNumber":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"maintenanceLogs":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"registration":{"type":"string","maxLength":20},"at":{"type":"string","maxLength":40},"taskCode":{"type":"string","maxLength":80},"description":{"type":"string","maxLength":400},"hours":{"type":"number","minimum":0,"maximum":100000},"cycles":{"type":"number","minimum":0,"maximum":1000000},"status":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"documents":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"subject":{"type":"string","maxLength":160},"documentType":{"type":"string","maxLength":80},"registration":{"type":"string","maxLength":20},"issuedAt":{"type":"string","maxLength":40},"expiresAt":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"groundTimes":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"airport":{"type":"string","maxLength":8},"flightNumber":{"type":"string","maxLength":20},"registration":{"type":"string","maxLength":20},"arrivalAt":{"type":"string","maxLength":40},"departureAt":{"type":"string","maxLength":40},"scheduledGroundMinutes":{"type":"number","minimum":0,"maximum":10000},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"emissionFactors":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"aircraftType":{"type":"string","maxLength":40},"kgCo2PerKm":{"type":"number","minimum":0,"maximum":1000},"kgCo2PerPassengerKm":{"type":"number","minimum":0,"maximum":10},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"connections":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"inboundFlightId":{"type":"string","maxLength":80},"outboundFlightId":{"type":"string","maxLength":80},"airport":{"type":"string","maxLength":8},"minimumConnectMinutes":{"type":"number","minimum":0,"maximum":1440},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"openSky":{"type":"object","properties":{"icao24":{"type":"string","minLength":1,"maxLength":12}},"required":["icao24"],"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"expiryWarningDays":{"type":"number","minimum":0,"maximum":3650}},"additionalProperties":false},"example":{"asOf":"2026-11-04T21:00:00.000Z","registrations":[{"id":"R1","registration":"G-STBA","aircraftType":"B777","manufacturer":"Boeing","model":"777-300ER","operator":"British Airways","country":"UK","source":"Caller-supplied"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"aircraftCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"registration":{"type":"string"},"icao24":{"type":"string"},"aircraftType":{"type":"string"},"manufacturer":{"type":"string"},"model":{"type":"string"},"operator":{"type":"string"},"owner":{"type":"string"},"country":{"type":"string"},"serialNumber":{"type":"string"},"source":{"type":"string"},"paidFlightTrackingUsed":{"type":"boolean"},"authenticatedAirlineSystemUsed":{"type":"boolean"}},"additionalProperties":true}},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"paidFlightTrackingUsed":{"type":"boolean"},"authenticatedAirlineSystemUsed":{"type":"boolean"},"openSkyFetched":{"type":"boolean"},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"looked_up","aircraftCount":1,"items":[{"id":"R1","registration":"G-STBA","icao24":"","aircraftType":"B777","manufacturer":"Boeing","model":"777-300ER","operator":"British Airways","owner":"","country":"UK","serialNumber":"","source":"Caller-supplied","paidFlightTrackingUsed":false,"authenticatedAirlineSystemUsed":false}],"paidProviderUsed":false,"apiKeyRequired":false,"paidFlightTrackingUsed":false,"authenticatedAirlineSystemUsed":false,"openSkyFetched":false,"findings":[],"limitations":["Flight schedules, diversions, registrations, maintenance logs, documents, ground times, emission factors, and connections are copied only from labeled fields supplied by the caller, or from key-free OpenSky aircraft metadata when openSky.icao24 is requested.","No paid flight-tracking API or authenticated airline system is used and no API key is required.","Delay, connection, diversion, ground-time, and emissions results use only supplied times/distances/factors (or a small disclosed public-style CO2 factor table when no factor or fuel burn is supplied).","Document expiry checks compare caller-supplied expiry dates to asOf only. Regulatory compliance is not determined.","Operations reports aggregate only sections for which records were supplied or optionally fetched."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]}}},"/api/v1/aviation-intelligence/aircraft-maintenance-log-parse":{"post":{"operationId":"parse_aircraft_maintenance_logs","summary":"Parse aircraft maintenance logs","description":"Parse caller-supplied maintenance log rows into normalized task entries and open-item flags.","tags":["aviation-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80}},"required":["fileBase64"],"additionalProperties":false},"files":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80}},"required":["fileBase64"],"additionalProperties":false}},"flights":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"flightNumber":{"type":"string","maxLength":20},"airline":{"type":"string","maxLength":120},"airlineIata":{"type":"string","maxLength":8},"origin":{"type":"string","maxLength":8},"destination":{"type":"string","maxLength":8},"scheduledDepartureAt":{"type":"string","maxLength":40},"scheduledArrivalAt":{"type":"string","maxLength":40},"actualDepartureAt":{"type":"string","maxLength":40},"actualArrivalAt":{"type":"string","maxLength":40},"status":{"type":"string","maxLength":80},"aircraftRegistration":{"type":"string","maxLength":20},"aircraftType":{"type":"string","maxLength":40},"distanceKm":{"type":"number","minimum":0,"maximum":40000},"seats":{"type":"number","minimum":0,"maximum":1000},"passengers":{"type":"number","minimum":0,"maximum":1000},"fuelBurnKg":{"type":"number","minimum":0,"maximum":1000000},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"diversions":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"flightId":{"type":"string","maxLength":80},"flightNumber":{"type":"string","maxLength":20},"plannedDestination":{"type":"string","maxLength":8},"diversionAirport":{"type":"string","maxLength":8},"divertedAt":{"type":"string","maxLength":40},"reason":{"type":"string","maxLength":200},"resumedAt":{"type":"string","maxLength":40},"finalDestination":{"type":"string","maxLength":8},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"registrations":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"registration":{"type":"string","maxLength":20},"icao24":{"type":"string","maxLength":12},"aircraftType":{"type":"string","maxLength":40},"manufacturer":{"type":"string","maxLength":120},"model":{"type":"string","maxLength":120},"operator":{"type":"string","maxLength":160},"owner":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"serialNumber":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"maintenanceLogs":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"registration":{"type":"string","maxLength":20},"at":{"type":"string","maxLength":40},"taskCode":{"type":"string","maxLength":80},"description":{"type":"string","maxLength":400},"hours":{"type":"number","minimum":0,"maximum":100000},"cycles":{"type":"number","minimum":0,"maximum":1000000},"status":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"documents":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"subject":{"type":"string","maxLength":160},"documentType":{"type":"string","maxLength":80},"registration":{"type":"string","maxLength":20},"issuedAt":{"type":"string","maxLength":40},"expiresAt":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"groundTimes":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"airport":{"type":"string","maxLength":8},"flightNumber":{"type":"string","maxLength":20},"registration":{"type":"string","maxLength":20},"arrivalAt":{"type":"string","maxLength":40},"departureAt":{"type":"string","maxLength":40},"scheduledGroundMinutes":{"type":"number","minimum":0,"maximum":10000},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"emissionFactors":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"aircraftType":{"type":"string","maxLength":40},"kgCo2PerKm":{"type":"number","minimum":0,"maximum":1000},"kgCo2PerPassengerKm":{"type":"number","minimum":0,"maximum":10},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"connections":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"inboundFlightId":{"type":"string","maxLength":80},"outboundFlightId":{"type":"string","maxLength":80},"airport":{"type":"string","maxLength":8},"minimumConnectMinutes":{"type":"number","minimum":0,"maximum":1440},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"openSky":{"type":"object","properties":{"icao24":{"type":"string","minLength":1,"maxLength":12}},"required":["icao24"],"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"expiryWarningDays":{"type":"number","minimum":0,"maximum":3650}},"additionalProperties":false},"example":{"asOf":"2026-11-04T21:00:00.000Z","maintenanceLogs":[{"id":"M1","registration":"G-STBA","at":"2026-10-01","taskCode":"A-CHK","description":"A check","hours":12,"status":"closed","source":"Caller-supplied"},{"id":"M2","registration":"G-STBA","at":"2026-11-01","taskCode":"DEF-1","description":"Deferred item","status":"open","source":"Caller-supplied"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"entryCount":{"type":"number"},"openCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"registration":{"type":"string"},"at":{"type":"string"},"taskCode":{"type":"string"},"description":{"type":"string"},"hours":{"type":"number"},"hoursSupplied":{"type":"boolean"},"cycles":{"type":"number"},"cyclesSupplied":{"type":"boolean"},"status":{"type":"string"},"open":{"type":"boolean"},"source":{"type":"string"},"paidFlightTrackingUsed":{"type":"boolean"}},"additionalProperties":true}},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"paidFlightTrackingUsed":{"type":"boolean"},"authenticatedAirlineSystemUsed":{"type":"boolean"},"openSkyFetched":{"type":"boolean"},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"parsed","entryCount":2,"openCount":1,"items":[{"id":"M1","registration":"G-STBA","at":"2026-10-01","taskCode":"A-CHK","description":"A check","hours":12,"hoursSupplied":true,"cycles":0,"cyclesSupplied":false,"status":"closed","open":false,"source":"Caller-supplied","paidFlightTrackingUsed":false},{"id":"M2","registration":"G-STBA","at":"2026-11-01","taskCode":"DEF-1","description":"Deferred item","hours":0,"hoursSupplied":false,"cycles":0,"cyclesSupplied":false,"status":"open","open":true,"source":"Caller-supplied","paidFlightTrackingUsed":false}],"paidProviderUsed":false,"apiKeyRequired":false,"paidFlightTrackingUsed":false,"authenticatedAirlineSystemUsed":false,"openSkyFetched":false,"findings":[],"limitations":["Flight schedules, diversions, registrations, maintenance logs, documents, ground times, emission factors, and connections are copied only from labeled fields supplied by the caller, or from key-free OpenSky aircraft metadata when openSky.icao24 is requested.","No paid flight-tracking API or authenticated airline system is used and no API key is required.","Delay, connection, diversion, ground-time, and emissions results use only supplied times/distances/factors (or a small disclosed public-style CO2 factor table when no factor or fuel burn is supplied).","Document expiry checks compare caller-supplied expiry dates to asOf only. Regulatory compliance is not determined.","Operations reports aggregate only sections for which records were supplied or optionally fetched."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/aviation-intelligence/document-expiry-check":{"post":{"operationId":"check_aviation_document_expiry","summary":"Check aviation document expiry","description":"Compare caller-supplied document expiry dates to asOf and flag expired or soon-expiring items. Regulatory compliance is not determined.","tags":["aviation-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80}},"required":["fileBase64"],"additionalProperties":false},"files":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80}},"required":["fileBase64"],"additionalProperties":false}},"flights":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"flightNumber":{"type":"string","maxLength":20},"airline":{"type":"string","maxLength":120},"airlineIata":{"type":"string","maxLength":8},"origin":{"type":"string","maxLength":8},"destination":{"type":"string","maxLength":8},"scheduledDepartureAt":{"type":"string","maxLength":40},"scheduledArrivalAt":{"type":"string","maxLength":40},"actualDepartureAt":{"type":"string","maxLength":40},"actualArrivalAt":{"type":"string","maxLength":40},"status":{"type":"string","maxLength":80},"aircraftRegistration":{"type":"string","maxLength":20},"aircraftType":{"type":"string","maxLength":40},"distanceKm":{"type":"number","minimum":0,"maximum":40000},"seats":{"type":"number","minimum":0,"maximum":1000},"passengers":{"type":"number","minimum":0,"maximum":1000},"fuelBurnKg":{"type":"number","minimum":0,"maximum":1000000},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"diversions":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"flightId":{"type":"string","maxLength":80},"flightNumber":{"type":"string","maxLength":20},"plannedDestination":{"type":"string","maxLength":8},"diversionAirport":{"type":"string","maxLength":8},"divertedAt":{"type":"string","maxLength":40},"reason":{"type":"string","maxLength":200},"resumedAt":{"type":"string","maxLength":40},"finalDestination":{"type":"string","maxLength":8},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"registrations":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"registration":{"type":"string","maxLength":20},"icao24":{"type":"string","maxLength":12},"aircraftType":{"type":"string","maxLength":40},"manufacturer":{"type":"string","maxLength":120},"model":{"type":"string","maxLength":120},"operator":{"type":"string","maxLength":160},"owner":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"serialNumber":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"maintenanceLogs":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"registration":{"type":"string","maxLength":20},"at":{"type":"string","maxLength":40},"taskCode":{"type":"string","maxLength":80},"description":{"type":"string","maxLength":400},"hours":{"type":"number","minimum":0,"maximum":100000},"cycles":{"type":"number","minimum":0,"maximum":1000000},"status":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"documents":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"subject":{"type":"string","maxLength":160},"documentType":{"type":"string","maxLength":80},"registration":{"type":"string","maxLength":20},"issuedAt":{"type":"string","maxLength":40},"expiresAt":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"groundTimes":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"airport":{"type":"string","maxLength":8},"flightNumber":{"type":"string","maxLength":20},"registration":{"type":"string","maxLength":20},"arrivalAt":{"type":"string","maxLength":40},"departureAt":{"type":"string","maxLength":40},"scheduledGroundMinutes":{"type":"number","minimum":0,"maximum":10000},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"emissionFactors":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"aircraftType":{"type":"string","maxLength":40},"kgCo2PerKm":{"type":"number","minimum":0,"maximum":1000},"kgCo2PerPassengerKm":{"type":"number","minimum":0,"maximum":10},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"connections":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"inboundFlightId":{"type":"string","maxLength":80},"outboundFlightId":{"type":"string","maxLength":80},"airport":{"type":"string","maxLength":8},"minimumConnectMinutes":{"type":"number","minimum":0,"maximum":1440},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"openSky":{"type":"object","properties":{"icao24":{"type":"string","minLength":1,"maxLength":12}},"required":["icao24"],"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"expiryWarningDays":{"type":"number","minimum":0,"maximum":3650}},"additionalProperties":false},"example":{"asOf":"2026-11-04T21:00:00.000Z","expiryWarningDays":30,"documents":[{"id":"DOC1","subject":"CoA","documentType":"certificate","registration":"G-STBA","issuedAt":"2025-01-01","expiresAt":"2026-11-20","source":"Caller-supplied"},{"id":"DOC2","subject":"Insurance","documentType":"insurance","registration":"G-STBA","expiresAt":"2026-10-01","source":"Caller-supplied"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"documentCount":{"type":"number"},"expiredCount":{"type":"number"},"expiringSoonCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"subject":{"type":"string"},"documentType":{"type":"string"},"registration":{"type":"string"},"issuedAt":{"type":"string"},"expiresAt":{"type":"string"},"daysRemaining":{"type":"number"},"daysRemainingSupplied":{"type":"boolean"},"status":{"type":"string"},"regulatoryComplianceDetermined":{"type":"boolean"},"source":{"type":"string"}},"additionalProperties":true}},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"paidFlightTrackingUsed":{"type":"boolean"},"authenticatedAirlineSystemUsed":{"type":"boolean"},"openSkyFetched":{"type":"boolean"},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"checked","documentCount":2,"expiredCount":1,"expiringSoonCount":1,"items":[{"id":"DOC1","subject":"CoA","documentType":"certificate","registration":"G-STBA","issuedAt":"2025-01-01","expiresAt":"2026-11-20","daysRemaining":15.125,"daysRemainingSupplied":true,"status":"expiring_soon","regulatoryComplianceDetermined":false,"source":"Caller-supplied"},{"id":"DOC2","subject":"Insurance","documentType":"insurance","registration":"G-STBA","issuedAt":"","expiresAt":"2026-10-01","daysRemaining":-34.875,"daysRemainingSupplied":true,"status":"expired","regulatoryComplianceDetermined":false,"source":"Caller-supplied"}],"paidProviderUsed":false,"apiKeyRequired":false,"paidFlightTrackingUsed":false,"authenticatedAirlineSystemUsed":false,"openSkyFetched":false,"findings":[{"kind":"conflict","code":"document_expiry","subject":"DOC1","detail":"Document is expiring_soon (15.125 days from asOf)."},{"kind":"conflict","code":"document_expiry","subject":"DOC2","detail":"Document is expired (-34.875 days from asOf)."}],"limitations":["Flight schedules, diversions, registrations, maintenance logs, documents, ground times, emission factors, and connections are copied only from labeled fields supplied by the caller, or from key-free OpenSky aircraft metadata when openSky.icao24 is requested.","No paid flight-tracking API or authenticated airline system is used and no API key is required.","Delay, connection, diversion, ground-time, and emissions results use only supplied times/distances/factors (or a small disclosed public-style CO2 factor table when no factor or fuel burn is supplied).","Document expiry checks compare caller-supplied expiry dates to asOf only. Regulatory compliance is not determined.","Operations reports aggregate only sections for which records were supplied or optionally fetched."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]}}},"/api/v1/aviation-intelligence/flight-emissions-estimate":{"post":{"operationId":"estimate_flight_emissions","summary":"Estimate flight emissions","description":"Estimate CO2 from caller-supplied fuel burn or distance with caller emission factors, falling back to a disclosed public-style factor table only when neither is supplied.","tags":["aviation-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80}},"required":["fileBase64"],"additionalProperties":false},"files":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80}},"required":["fileBase64"],"additionalProperties":false}},"flights":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"flightNumber":{"type":"string","maxLength":20},"airline":{"type":"string","maxLength":120},"airlineIata":{"type":"string","maxLength":8},"origin":{"type":"string","maxLength":8},"destination":{"type":"string","maxLength":8},"scheduledDepartureAt":{"type":"string","maxLength":40},"scheduledArrivalAt":{"type":"string","maxLength":40},"actualDepartureAt":{"type":"string","maxLength":40},"actualArrivalAt":{"type":"string","maxLength":40},"status":{"type":"string","maxLength":80},"aircraftRegistration":{"type":"string","maxLength":20},"aircraftType":{"type":"string","maxLength":40},"distanceKm":{"type":"number","minimum":0,"maximum":40000},"seats":{"type":"number","minimum":0,"maximum":1000},"passengers":{"type":"number","minimum":0,"maximum":1000},"fuelBurnKg":{"type":"number","minimum":0,"maximum":1000000},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"diversions":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"flightId":{"type":"string","maxLength":80},"flightNumber":{"type":"string","maxLength":20},"plannedDestination":{"type":"string","maxLength":8},"diversionAirport":{"type":"string","maxLength":8},"divertedAt":{"type":"string","maxLength":40},"reason":{"type":"string","maxLength":200},"resumedAt":{"type":"string","maxLength":40},"finalDestination":{"type":"string","maxLength":8},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"registrations":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"registration":{"type":"string","maxLength":20},"icao24":{"type":"string","maxLength":12},"aircraftType":{"type":"string","maxLength":40},"manufacturer":{"type":"string","maxLength":120},"model":{"type":"string","maxLength":120},"operator":{"type":"string","maxLength":160},"owner":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"serialNumber":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"maintenanceLogs":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"registration":{"type":"string","maxLength":20},"at":{"type":"string","maxLength":40},"taskCode":{"type":"string","maxLength":80},"description":{"type":"string","maxLength":400},"hours":{"type":"number","minimum":0,"maximum":100000},"cycles":{"type":"number","minimum":0,"maximum":1000000},"status":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"documents":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"subject":{"type":"string","maxLength":160},"documentType":{"type":"string","maxLength":80},"registration":{"type":"string","maxLength":20},"issuedAt":{"type":"string","maxLength":40},"expiresAt":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"groundTimes":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"airport":{"type":"string","maxLength":8},"flightNumber":{"type":"string","maxLength":20},"registration":{"type":"string","maxLength":20},"arrivalAt":{"type":"string","maxLength":40},"departureAt":{"type":"string","maxLength":40},"scheduledGroundMinutes":{"type":"number","minimum":0,"maximum":10000},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"emissionFactors":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"aircraftType":{"type":"string","maxLength":40},"kgCo2PerKm":{"type":"number","minimum":0,"maximum":1000},"kgCo2PerPassengerKm":{"type":"number","minimum":0,"maximum":10},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"connections":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"inboundFlightId":{"type":"string","maxLength":80},"outboundFlightId":{"type":"string","maxLength":80},"airport":{"type":"string","maxLength":8},"minimumConnectMinutes":{"type":"number","minimum":0,"maximum":1440},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"openSky":{"type":"object","properties":{"icao24":{"type":"string","minLength":1,"maxLength":12}},"required":["icao24"],"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"expiryWarningDays":{"type":"number","minimum":0,"maximum":3650}},"additionalProperties":false},"example":{"asOf":"2026-11-04T21:00:00.000Z","flights":[{"id":"F1","flightNumber":"BA100","aircraftType":"B777","distanceKm":5540,"passengers":250,"source":"Caller-supplied"}],"emissionFactors":[{"aircraftType":"B777","kgCo2PerKm":22,"source":"Caller-supplied factor"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"flightCount":{"type":"number"},"totalKgCo2":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"flightNumber":{"type":"string"},"aircraftType":{"type":"string"},"distanceKm":{"type":"number"},"distanceKmSupplied":{"type":"boolean"},"fuelBurnKg":{"type":"number"},"fuelBurnKgSupplied":{"type":"boolean"},"kgCo2":{"type":"number"},"kgCo2Supplied":{"type":"boolean"},"kgCo2PerPassenger":{"type":"number"},"kgCo2PerPassengerSupplied":{"type":"boolean"},"method":{"type":"string"},"factorSource":{"type":"string"},"source":{"type":"string"},"paidFlightTrackingUsed":{"type":"boolean"}},"additionalProperties":true}},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"paidFlightTrackingUsed":{"type":"boolean"},"authenticatedAirlineSystemUsed":{"type":"boolean"},"openSkyFetched":{"type":"boolean"},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"estimated","flightCount":1,"totalKgCo2":121880,"items":[{"id":"F1","flightNumber":"BA100","aircraftType":"B777","distanceKm":5540,"distanceKmSupplied":true,"fuelBurnKg":0,"fuelBurnKgSupplied":false,"kgCo2":121880,"kgCo2Supplied":true,"kgCo2PerPassenger":487.52,"kgCo2PerPassengerSupplied":true,"method":"caller_kgco2_per_km","factorSource":"Caller-supplied factor","source":"Caller-supplied","paidFlightTrackingUsed":false}],"paidProviderUsed":false,"apiKeyRequired":false,"paidFlightTrackingUsed":false,"authenticatedAirlineSystemUsed":false,"openSkyFetched":false,"findings":[],"limitations":["Flight schedules, diversions, registrations, maintenance logs, documents, ground times, emission factors, and connections are copied only from labeled fields supplied by the caller, or from key-free OpenSky aircraft metadata when openSky.icao24 is requested.","No paid flight-tracking API or authenticated airline system is used and no API key is required.","Delay, connection, diversion, ground-time, and emissions results use only supplied times/distances/factors (or a small disclosed public-style CO2 factor table when no factor or fuel burn is supplied).","Document expiry checks compare caller-supplied expiry dates to asOf only. Regulatory compliance is not determined.","Operations reports aggregate only sections for which records were supplied or optionally fetched."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/aviation-intelligence/airport-ground-time-analyze":{"post":{"operationId":"analyze_airport_ground_time","summary":"Analyze airport ground time","description":"Analyze caller-supplied arrival/departure ground times against scheduled turn times.","tags":["aviation-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80}},"required":["fileBase64"],"additionalProperties":false},"files":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80}},"required":["fileBase64"],"additionalProperties":false}},"flights":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"flightNumber":{"type":"string","maxLength":20},"airline":{"type":"string","maxLength":120},"airlineIata":{"type":"string","maxLength":8},"origin":{"type":"string","maxLength":8},"destination":{"type":"string","maxLength":8},"scheduledDepartureAt":{"type":"string","maxLength":40},"scheduledArrivalAt":{"type":"string","maxLength":40},"actualDepartureAt":{"type":"string","maxLength":40},"actualArrivalAt":{"type":"string","maxLength":40},"status":{"type":"string","maxLength":80},"aircraftRegistration":{"type":"string","maxLength":20},"aircraftType":{"type":"string","maxLength":40},"distanceKm":{"type":"number","minimum":0,"maximum":40000},"seats":{"type":"number","minimum":0,"maximum":1000},"passengers":{"type":"number","minimum":0,"maximum":1000},"fuelBurnKg":{"type":"number","minimum":0,"maximum":1000000},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"diversions":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"flightId":{"type":"string","maxLength":80},"flightNumber":{"type":"string","maxLength":20},"plannedDestination":{"type":"string","maxLength":8},"diversionAirport":{"type":"string","maxLength":8},"divertedAt":{"type":"string","maxLength":40},"reason":{"type":"string","maxLength":200},"resumedAt":{"type":"string","maxLength":40},"finalDestination":{"type":"string","maxLength":8},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"registrations":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"registration":{"type":"string","maxLength":20},"icao24":{"type":"string","maxLength":12},"aircraftType":{"type":"string","maxLength":40},"manufacturer":{"type":"string","maxLength":120},"model":{"type":"string","maxLength":120},"operator":{"type":"string","maxLength":160},"owner":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"serialNumber":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"maintenanceLogs":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"registration":{"type":"string","maxLength":20},"at":{"type":"string","maxLength":40},"taskCode":{"type":"string","maxLength":80},"description":{"type":"string","maxLength":400},"hours":{"type":"number","minimum":0,"maximum":100000},"cycles":{"type":"number","minimum":0,"maximum":1000000},"status":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"documents":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"subject":{"type":"string","maxLength":160},"documentType":{"type":"string","maxLength":80},"registration":{"type":"string","maxLength":20},"issuedAt":{"type":"string","maxLength":40},"expiresAt":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"groundTimes":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"airport":{"type":"string","maxLength":8},"flightNumber":{"type":"string","maxLength":20},"registration":{"type":"string","maxLength":20},"arrivalAt":{"type":"string","maxLength":40},"departureAt":{"type":"string","maxLength":40},"scheduledGroundMinutes":{"type":"number","minimum":0,"maximum":10000},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"emissionFactors":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"aircraftType":{"type":"string","maxLength":40},"kgCo2PerKm":{"type":"number","minimum":0,"maximum":1000},"kgCo2PerPassengerKm":{"type":"number","minimum":0,"maximum":10},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"connections":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"inboundFlightId":{"type":"string","maxLength":80},"outboundFlightId":{"type":"string","maxLength":80},"airport":{"type":"string","maxLength":8},"minimumConnectMinutes":{"type":"number","minimum":0,"maximum":1440},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"openSky":{"type":"object","properties":{"icao24":{"type":"string","minLength":1,"maxLength":12}},"required":["icao24"],"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"expiryWarningDays":{"type":"number","minimum":0,"maximum":3650}},"additionalProperties":false},"example":{"asOf":"2026-11-04T21:00:00.000Z","groundTimes":[{"id":"G1","airport":"JFK","flightNumber":"BA100","arrivalAt":"2026-11-01T18:50:00.000Z","departureAt":"2026-11-01T20:10:00.000Z","scheduledGroundMinutes":60,"source":"Caller-supplied"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"sampleCount":{"type":"number"},"extendedCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"airport":{"type":"string"},"flightNumber":{"type":"string"},"registration":{"type":"string"},"arrivalAt":{"type":"string"},"departureAt":{"type":"string"},"actualGroundMinutes":{"type":"number"},"actualGroundMinutesSupplied":{"type":"boolean"},"scheduledGroundMinutes":{"type":"number"},"scheduledGroundMinutesSupplied":{"type":"boolean"},"varianceMinutes":{"type":"number"},"varianceMinutesSupplied":{"type":"boolean"},"extended":{"type":"boolean"},"source":{"type":"string"},"paidFlightTrackingUsed":{"type":"boolean"}},"additionalProperties":true}},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"paidFlightTrackingUsed":{"type":"boolean"},"authenticatedAirlineSystemUsed":{"type":"boolean"},"openSkyFetched":{"type":"boolean"},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"analyzed","sampleCount":1,"extendedCount":1,"items":[{"id":"G1","airport":"JFK","flightNumber":"BA100","registration":"","arrivalAt":"2026-11-01T18:50:00.000Z","departureAt":"2026-11-01T20:10:00.000Z","actualGroundMinutes":80,"actualGroundMinutesSupplied":true,"scheduledGroundMinutes":60,"scheduledGroundMinutesSupplied":true,"varianceMinutes":20,"varianceMinutesSupplied":true,"extended":true,"source":"Caller-supplied","paidFlightTrackingUsed":false}],"paidProviderUsed":false,"apiKeyRequired":false,"paidFlightTrackingUsed":false,"authenticatedAirlineSystemUsed":false,"openSkyFetched":false,"findings":[],"limitations":["Flight schedules, diversions, registrations, maintenance logs, documents, ground times, emission factors, and connections are copied only from labeled fields supplied by the caller, or from key-free OpenSky aircraft metadata when openSky.icao24 is requested.","No paid flight-tracking API or authenticated airline system is used and no API key is required.","Delay, connection, diversion, ground-time, and emissions results use only supplied times/distances/factors (or a small disclosed public-style CO2 factor table when no factor or fuel burn is supplied).","Document expiry checks compare caller-supplied expiry dates to asOf only. Regulatory compliance is not determined.","Operations reports aggregate only sections for which records were supplied or optionally fetched."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]}}},"/api/v1/aviation-intelligence/operations-report":{"post":{"operationId":"build_aviation_operations_report","summary":"Build aviation operations report","description":"Aggregate schedule normalization, delay patterns, connection risk, diversions, registrations, maintenance, document expiry, emissions, and ground time from caller-supplied records only.","tags":["aviation-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80}},"required":["fileBase64"],"additionalProperties":false},"files":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/octet-stream"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000},"role":{"type":"string","maxLength":80}},"required":["fileBase64"],"additionalProperties":false}},"flights":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"flightNumber":{"type":"string","maxLength":20},"airline":{"type":"string","maxLength":120},"airlineIata":{"type":"string","maxLength":8},"origin":{"type":"string","maxLength":8},"destination":{"type":"string","maxLength":8},"scheduledDepartureAt":{"type":"string","maxLength":40},"scheduledArrivalAt":{"type":"string","maxLength":40},"actualDepartureAt":{"type":"string","maxLength":40},"actualArrivalAt":{"type":"string","maxLength":40},"status":{"type":"string","maxLength":80},"aircraftRegistration":{"type":"string","maxLength":20},"aircraftType":{"type":"string","maxLength":40},"distanceKm":{"type":"number","minimum":0,"maximum":40000},"seats":{"type":"number","minimum":0,"maximum":1000},"passengers":{"type":"number","minimum":0,"maximum":1000},"fuelBurnKg":{"type":"number","minimum":0,"maximum":1000000},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"diversions":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"flightId":{"type":"string","maxLength":80},"flightNumber":{"type":"string","maxLength":20},"plannedDestination":{"type":"string","maxLength":8},"diversionAirport":{"type":"string","maxLength":8},"divertedAt":{"type":"string","maxLength":40},"reason":{"type":"string","maxLength":200},"resumedAt":{"type":"string","maxLength":40},"finalDestination":{"type":"string","maxLength":8},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"registrations":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"registration":{"type":"string","maxLength":20},"icao24":{"type":"string","maxLength":12},"aircraftType":{"type":"string","maxLength":40},"manufacturer":{"type":"string","maxLength":120},"model":{"type":"string","maxLength":120},"operator":{"type":"string","maxLength":160},"owner":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"serialNumber":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"maintenanceLogs":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"registration":{"type":"string","maxLength":20},"at":{"type":"string","maxLength":40},"taskCode":{"type":"string","maxLength":80},"description":{"type":"string","maxLength":400},"hours":{"type":"number","minimum":0,"maximum":100000},"cycles":{"type":"number","minimum":0,"maximum":1000000},"status":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"documents":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"subject":{"type":"string","maxLength":160},"documentType":{"type":"string","maxLength":80},"registration":{"type":"string","maxLength":20},"issuedAt":{"type":"string","maxLength":40},"expiresAt":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"groundTimes":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"airport":{"type":"string","maxLength":8},"flightNumber":{"type":"string","maxLength":20},"registration":{"type":"string","maxLength":20},"arrivalAt":{"type":"string","maxLength":40},"departureAt":{"type":"string","maxLength":40},"scheduledGroundMinutes":{"type":"number","minimum":0,"maximum":10000},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"emissionFactors":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"aircraftType":{"type":"string","maxLength":40},"kgCo2PerKm":{"type":"number","minimum":0,"maximum":1000},"kgCo2PerPassengerKm":{"type":"number","minimum":0,"maximum":10},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"connections":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"inboundFlightId":{"type":"string","maxLength":80},"outboundFlightId":{"type":"string","maxLength":80},"airport":{"type":"string","maxLength":8},"minimumConnectMinutes":{"type":"number","minimum":0,"maximum":1440},"source":{"type":"string","maxLength":200}},"additionalProperties":false}},"openSky":{"type":"object","properties":{"icao24":{"type":"string","minLength":1,"maxLength":12}},"required":["icao24"],"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"expiryWarningDays":{"type":"number","minimum":0,"maximum":3650}},"additionalProperties":false},"example":{"asOf":"2026-11-04T21:00:00.000Z","expiryWarningDays":30,"flights":[{"id":"F1","flightNumber":"BA100","airlineIata":"BA","origin":"LHR","destination":"JFK","scheduledDepartureAt":"2026-11-01T10:00:00.000Z","scheduledArrivalAt":"2026-11-01T18:00:00.000Z","actualDepartureAt":"2026-11-01T10:40:00.000Z","actualArrivalAt":"2026-11-01T18:50:00.000Z","aircraftType":"B777","aircraftRegistration":"G-STBA","distanceKm":5540,"passengers":250,"source":"Caller-supplied"},{"id":"F2","flightNumber":"BA117","airlineIata":"BA","origin":"JFK","destination":"LHR","scheduledDepartureAt":"2026-11-01T20:00:00.000Z","scheduledArrivalAt":"2026-11-02T07:00:00.000Z","actualDepartureAt":"2026-11-01T20:10:00.000Z","actualArrivalAt":"2026-11-02T07:05:00.000Z","aircraftType":"B777","distanceKm":5540,"source":"Caller-supplied"}],"connections":[{"id":"C1","inboundFlightId":"F1","outboundFlightId":"F2","airport":"JFK","minimumConnectMinutes":90,"source":"Caller-supplied"}],"diversions":[{"id":"D1","flightNumber":"BA100","plannedDestination":"JFK","diversionAirport":"BOS","divertedAt":"2026-11-01T16:00:00.000Z","resumedAt":"2026-11-01T19:00:00.000Z","reason":"weather","source":"Caller-supplied"}],"registrations":[{"id":"R1","registration":"G-STBA","aircraftType":"B777","manufacturer":"Boeing","operator":"British Airways","source":"Caller-supplied"}],"maintenanceLogs":[{"id":"M2","registration":"G-STBA","taskCode":"DEF-1","description":"Deferred item","status":"open","source":"Caller-supplied"}],"documents":[{"id":"DOC1","subject":"CoA","documentType":"certificate","registration":"G-STBA","expiresAt":"2026-11-20","source":"Caller-supplied"}],"groundTimes":[{"id":"G1","airport":"JFK","flightNumber":"BA100","arrivalAt":"2026-11-01T18:50:00.000Z","departureAt":"2026-11-01T20:10:00.000Z","scheduledGroundMinutes":60,"source":"Caller-supplied"}],"emissionFactors":[{"aircraftType":"B777","kgCo2PerKm":22,"source":"Caller-supplied factor"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"asOf":{"type":"string"},"sections":{"type":"object","properties":{"schedule":{"type":"object","properties":{"flightCount":{"type":"number"}},"additionalProperties":true},"delayPatterns":{"type":"object","properties":{"patternCount":{"type":"number"}},"additionalProperties":true},"connections":{"type":"object","properties":{"connectionCount":{"type":"number"},"highRiskCount":{"type":"number"}},"additionalProperties":true},"diversions":{"type":"object","properties":{"eventCount":{"type":"number"},"activeCount":{"type":"number"}},"additionalProperties":true},"registrations":{"type":"object","properties":{"aircraftCount":{"type":"number"}},"additionalProperties":true},"maintenance":{"type":"object","properties":{"entryCount":{"type":"number"},"openCount":{"type":"number"}},"additionalProperties":true},"documents":{"type":"object","properties":{"documentCount":{"type":"number"},"expiredCount":{"type":"number"},"expiringSoonCount":{"type":"number"}},"additionalProperties":true},"emissions":{"type":"object","properties":{"flightCount":{"type":"number"},"totalKgCo2":{"type":"number"}},"additionalProperties":true},"groundTime":{"type":"object","properties":{"sampleCount":{"type":"number"},"extendedCount":{"type":"number"}},"additionalProperties":true}},"additionalProperties":true},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"paidFlightTrackingUsed":{"type":"boolean"},"authenticatedAirlineSystemUsed":{"type":"boolean"},"openSkyFetched":{"type":"boolean"},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"reported","asOf":"2026-11-04T21:00:00.000Z","sections":{"schedule":{"flightCount":2},"delayPatterns":{"patternCount":2},"connections":{"connectionCount":1,"highRiskCount":1},"diversions":{"eventCount":1,"activeCount":0},"registrations":{"aircraftCount":1},"maintenance":{"entryCount":1,"openCount":1},"documents":{"documentCount":1,"expiredCount":0,"expiringSoonCount":1},"emissions":{"flightCount":2,"totalKgCo2":243760},"groundTime":{"sampleCount":1,"extendedCount":1}},"paidProviderUsed":false,"apiKeyRequired":false,"paidFlightTrackingUsed":false,"authenticatedAirlineSystemUsed":false,"openSkyFetched":false,"findings":[],"limitations":["Flight schedules, diversions, registrations, maintenance logs, documents, ground times, emission factors, and connections are copied only from labeled fields supplied by the caller, or from key-free OpenSky aircraft metadata when openSky.icao24 is requested.","No paid flight-tracking API or authenticated airline system is used and no API key is required.","Delay, connection, diversion, ground-time, and emissions results use only supplied times/distances/factors (or a small disclosed public-style CO2 factor table when no factor or fuel burn is supplied).","Document expiry checks compare caller-supplied expiry dates to asOf only. Regulatory compliance is not determined.","Operations reports aggregate only sections for which records were supplied or optionally fetched."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.08"},"protocols":[{"x402":{}}]}}}},"components":{"schemas":{"ApiError":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}