{"openapi":"3.1.0","info":{"title":"VAT Ledger API","version":"1.0.0","description":"Read-only access to VAT Ledger's observed and inferred VATSIM operations archive. Filed, observed and detected values retain their distinct meanings."},"servers":[{"url":"/api/v1","description":"Current host"}],"security":[{"ApiKey":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"http","scheme":"bearer","bearerFormat":"VAT Ledger API key"}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}},"responses":{"Unauthorized":{"description":"Missing, invalid or revoked API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"RateLimited":{"description":"Minute or daily quota exceeded","headers":{"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"}},"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/network":{"get":{"summary":"Current network numbers","operationId":"getNetwork","responses":{"200":{"description":"Latest complete network snapshot"},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/airports":{"get":{"summary":"Rank airports by detected movements","operationId":"getAirports","parameters":[{"name":"hours","in":"query","schema":{"type":"integer","minimum":1,"maximum":744,"default":24}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}}],"responses":{"200":{"description":"Ranked airport movement totals"},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/airports/{icao}":{"get":{"summary":"Airport statistics and movement evidence","operationId":"getAirport","description":"Costs two quota units.","parameters":[{"name":"icao","in":"path","required":true,"schema":{"type":"string","pattern":"^[A-Z0-9]{3,4}$"}},{"name":"days","in":"query","schema":{"type":"integer","minimum":1,"maximum":365,"default":30}}],"responses":{"200":{"description":"Airport statistics"},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/events":{"get":{"summary":"List VATSIM events and attributed statistics","operationId":"getEvents","parameters":[{"name":"scope","in":"query","schema":{"type":"string","enum":["upcoming","past","all"],"default":"upcoming"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}}],"responses":{"200":{"description":"Event summaries"},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/RateLimited"}}}}}}