{"openapi":"3.1.0","info":{"title":"StarlinkFly public evidence snapshots","version":"1.0.0","description":"Aircraft installation, scheduled assignment and working connectivity are different facts. Missing records do not mean no Starlink. These snapshots do not confirm availability on a travel date. Read-only, no authentication. Cite citation_url; preserve original source rights. Limits: 60/IP/min and 600 global/min."},"servers":[{"url":"https://www.starlinkfly.com"}],"externalDocs":{"url":"https://www.starlinkfly.com/developers"},"paths":{"/data/airlines.json":{"get":{"summary":"List airline evidence","parameters":[{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"maximum":9999,"default":1}}],"responses":{"200":{"description":"Stored public evidence, cached for up to 300 seconds","headers":{"ETag":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvidenceResponse"}}}},"304":{"description":"Unchanged ETag"},"400":{"description":"Invalid, missing, unsupported or unavailable resource","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Invalid, missing, unsupported or unavailable resource","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Invalid, missing, unsupported or unavailable resource","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit; Retry-After: 60","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid, missing, unsupported or unavailable resource","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/data/airlines/{code}.json":{"get":{"summary":"Read airline evidence","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9]{2}$"},"example":"ua"}],"responses":{"200":{"description":"Stored public evidence, cached for up to 300 seconds","headers":{"ETag":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvidenceResponse"}}}},"304":{"description":"Unchanged ETag"},"400":{"description":"Invalid, missing, unsupported or unavailable resource","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Invalid, missing, unsupported or unavailable resource","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Invalid, missing, unsupported or unavailable resource","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit; Retry-After: 60","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid, missing, unsupported or unavailable resource","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/data/airlines/{code}/aircraft.json":{"get":{"summary":"List published aircraft evidence","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9]{2}$"},"example":"ua"},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"maximum":9999,"default":1}}],"responses":{"200":{"description":"Stored public evidence, cached for up to 300 seconds","headers":{"ETag":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvidenceResponse"}}}},"304":{"description":"Unchanged ETag"},"400":{"description":"Invalid, missing, unsupported or unavailable resource","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Invalid, missing, unsupported or unavailable resource","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Invalid, missing, unsupported or unavailable resource","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit; Retry-After: 60","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid, missing, unsupported or unavailable resource","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/data/flights.json":{"get":{"summary":"Discover published flight snapshots","parameters":[{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"maximum":9999,"default":1}}],"responses":{"200":{"description":"Stored public evidence, cached for up to 300 seconds","headers":{"ETag":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvidenceResponse"}}}},"304":{"description":"Unchanged ETag"},"400":{"description":"Invalid, missing, unsupported or unavailable resource","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Invalid, missing, unsupported or unavailable resource","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Invalid, missing, unsupported or unavailable resource","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit; Retry-After: 60","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid, missing, unsupported or unavailable resource","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/data/flights/{number}.json":{"get":{"summary":"Read limited recorded flight associations","parameters":[{"name":"number","in":"path","required":true,"schema":{"type":"string","pattern":"^ua[0-9]{1,4}$"},"example":"ua1006"}],"responses":{"200":{"description":"Stored public evidence, cached for up to 300 seconds","headers":{"ETag":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvidenceResponse"}}}},"304":{"description":"Unchanged ETag"},"400":{"description":"Invalid, missing, unsupported or unavailable resource","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Invalid, missing, unsupported or unavailable resource","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Invalid, missing, unsupported or unavailable resource","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit; Retry-After: 60","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid, missing, unsupported or unavailable resource","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}},"EvidenceResponse":{"type":"object","required":["schema_version","limitations"],"properties":{"schema_version":{"type":"string","const":"1.0"},"limitations":{"type":"string"},"evidence_level":{"type":"string"},"evidence_date":{"type":["string","null"]},"source_updated_at":{"type":["string","null"]},"citation_url":{"type":"string","format":"uri"},"source_url":{"type":["string","null"]},"flight_availability":{"type":"string"},"history_complete":{"type":"boolean"},"page":{"type":"integer"},"page_size":{"type":"integer"},"total":{"type":"integer"},"next":{"type":["string","null"]},"items":{"type":"array","items":{"type":"object","additionalProperties":true}},"records":{"type":"array","items":{"type":"object","additionalProperties":true}}},"additionalProperties":true}}}}