Aviation Edge · OpenAPI Overlay 1.0.0

Aviation Edge notams-api enhancements

5 actions 5 updates update extends aviation-edge-notams-api-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for Aviation Edge's API. It is a proposal applied on top of the contract, not a document Aviation Edge publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-api-evangelist-sourcex-error-envelopex-conventionsx-rate-limitsx-agentic-access

Targets 2

$.info

$.paths['/notams'].get

OpenAPI Overlay

overlay: 1.0.0
info:
  title: Aviation Edge notams-api enhancements
  version: 1.0.0
extends: aviation-edge-notams-api-openapi.yml
x-provenance:
  generated: '2026-09-04'
  method: generated
  source: Generated from this repository's artifacts; captures API Evangelist enhancements without mutating openapi/aviation-edge-notams-api-openapi.yml
actions:
- target: $.info
  description: Record the harvest provenance of this contract on the document itself.
  update:
    x-api-evangelist-source: Harvested from github.com/AviationEdgeAPI README request/response examples and https://aviation-edge.com/developers/,
      then confirmed with live unauthenticated probes of https://aviation-edge.com/v2/public/ on 2026-09-04.
- target: $.info
  description: State the error contract in the document itself, because the API returns most errors with HTTP 200.
  update:
    x-error-envelope:
      shape: '{"error"|"message": <string|object>, "success": false}'
      http_status_on_error: 200 for auth and most usage errors; 400 on /flightsHistory and /flightsFuture for a
        missing required parameter; 404 with an HTML body for an unknown path
      catalog: errors/aviation-edge-problem-types.yml
- target: $.info
  description: Declare the runtime semantics an agent needs before calling.
  update:
    x-conventions:
      read_only: true
      idempotency: na
      reversibility: na
      pagination: none (limit is a result cap, max 30000, on /flights and /satelliteDetails)
      rate_limit_headers: none observed
      artifact: conventions/aviation-edge-conventions.yml
- target: $.info
  description: Record the quota model, which is monthly per key and invisible at runtime.
  update:
    x-rate-limits:
      model: monthly call allowance per subscription key
      tiers:
        Developer: 30000
        Business: 100000
        Business Gold: 500000
        Unlimited Data: null
      artifact: rate-limits/aviation-edge-rate-limits.yml
- target: $.paths['/notams'].get
  description: 'Classify getNotams for agent execution: a read with no side effects.'
  update:
    x-agentic-access:
      action-class: connected
      consequence: read
      subject: optional
      token:
        max-ttl: 3600
      audit: none

Work with this as data

Every overlay here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for openapi overlays

4 MCP tools reach this

find_overlaysBrowse and filter every overlay in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This overlay

curl "https://apis.io/api/v1/overlays/aviation-edge-notams-api-overlay"

All openapi overlays

curl "https://apis.io/api/v1/overlays?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.