{"openapi":"3.1.0","info":{"title":"AVIATOR API","version":"1.0.0","description":"Read-only commercial aviation intelligence API."},"servers":[{"url":"https://api.aviator.aero"}],"paths":{"/v1/news":{"get":{"summary":"List published News transactions","security":[{"bearerAuth":[]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":true}},"meta":{"type":"object","required":["request_id","limit","offset","total"],"properties":{"request_id":{"type":"string","format":"uuid"},"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"}}}}}}}},"401":{"description":"Missing, invalid, or inactive credential"},"403":{"description":"Credential lacks news:read"},"429":{"description":"Client rate limit exceeded"},"500":{"description":"Request could not be completed"}},"x-required-scope":"news:read"}},"/v1/companies":{"get":{"summary":"List active canonical companies","security":[{"bearerAuth":[]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0}},{"name":"q","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":true}},"meta":{"type":"object","required":["request_id","limit","offset","total"],"properties":{"request_id":{"type":"string","format":"uuid"},"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"}}}}}}}},"401":{"description":"Missing, invalid, or inactive credential"},"403":{"description":"Credential lacks companies:read"},"429":{"description":"Client rate limit exceeded"},"500":{"description":"Request could not be completed"}},"x-required-scope":"companies:read"}},"/v1/press":{"get":{"summary":"List published Press Room articles","security":[{"bearerAuth":[]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":true}},"meta":{"type":"object","required":["request_id","limit","offset","total"],"properties":{"request_id":{"type":"string","format":"uuid"},"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"}}}}}}}},"401":{"description":"Missing, invalid, or inactive credential"},"403":{"description":"Credential lacks press:read"},"429":{"description":"Client rate limit exceeded"},"500":{"description":"Request could not be completed"}},"x-required-scope":"press:read"}},"/v1/macro":{"get":{"summary":"List published Macro indicators","security":[{"bearerAuth":[]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":true}},"meta":{"type":"object","required":["request_id","limit","offset","total"],"properties":{"request_id":{"type":"string","format":"uuid"},"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"}}}}}}}},"401":{"description":"Missing, invalid, or inactive credential"},"403":{"description":"Credential lacks macro:read"},"429":{"description":"Client rate limit exceeded"},"500":{"description":"Request could not be completed"}},"x-required-scope":"macro:read"}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"av_live_… or av_test_…"}}}}