API reference
Machine-readable reference for the BravoEcho aviation data API. Written for coding agents and for people who prefer one file to a docs site. Everything here is the current contract; fields may be added, existing fields will not be renamed or removed without a version bump.
Status, per product (the same on the REST API and, for agents, on the MCP server; see MCP):
- Available (production): RAIM prediction, route check, trajectory and world map, and the RAIM reference endpoints. Counted for pricing. The flight briefing pack and alerts count as the services they use: one request for each part they run, each counted as its own service is (so today only their RAIM part is counted).
- Beta (live, free while in beta, not counted or billed; answers may change shape and coverage may be partial; before a beta service starts counting, the organisation gets at least 7 days' notice by email): the NOTAM archive (search, route, detail, history), the weather archive (METAR, TAF, hazards, weather along a route, winds aloft along a route), the airspace a flight enters (special use airspace, Class B, C and D, TFRs; United States), airports, navaids and route strings, mass and balance and a navlog on the aircraft data you send, and alerts by webhook on a flight.
Every /v1 response says which it is in two headers: X-Product-Status (ga or beta) and X-Metered (true or false). The OpenAPI 3.1 description, https://bravoecho.ai/openapi.json, has every Available and Beta endpoint with x-status: available | beta on each operation.
Coverage: RAIM is worldwide. METAR and TAF are worldwide (every station NOAA's Aviation Weather Center reports). NOTAMs (the FAA's domestic set and the international NOTAMs the FAA distributes), route strings (named fixes, airways and procedures come from the FAA CIFP, US only) and en-route weather advisories (G-AIRMET and CWA are US products; international SIGMETs are worldwide) are fullest in the United States for now.
Server-side only: call the API from server-side code (a backend route or an edge function), never from a browser, and keep the key in a secret. The API sends no CORS headers, so a browser on another origin cannot read its answers; a key in a web page or a client bundle is a leaked key.
- Getting a key Keys come from the console at https://app.bravoecho.ai, no email needed.
- Base URL, auth, conventions Base URL: https://api.bravoecho.ai/v1 Auth: Authorization: Bearer $BRAVOECHO_KEY on every request. JSON in, JSON out. Content-Type: application/json.…
- Errors Every error has one shape, a code and a sentence:
- Limits and pricing Rate limit per key: 60 requests a minute on Free, 600 (10 a second) on pay as you go. Ask for more; it costs nothing extra. World maps (POST…
- RAIM predictionAvailable Predicts GNSS RAIM availability at each point you give, for a window around each point's time, using the GPS (and optionally Galileo) almanac and the…
- Flight object POST /v1/raim/route, POST /v1/notams/route, POST /v1/weather/route and POST /v1/airspace/route take the same flight object, so one object can go to all…
- RAIM route checkAvailable A flight plan flown along great-circle legs, RAIM evaluated at the aircraft's position and time at every step. The flight is the flight object (see…
- RAIM trajectory and world mapAvailable POST /v1/raim/trajectory: one position over up to 72 h (the length of an AUGUR scenario) with satellite geometry (passes[] with azimuth, elevation and…
- NOTAMsBeta The NOTAM archive: every NOTAM the FAA NOTAM Management Service distributes (US domestic, FDC, military and the international feed, worldwide), collected…
- Airports and navaidsBeta Reference data from OurAirports (public domain, community maintained, refreshed nightly): airports, runways, COM frequencies and navaids worldwide. Route…
- WeatherBeta The weather archive: METAR, TAF, SIGMETs (international and US), G-AIRMETs and CWAs from aviationweather.gov, collected since 2026-09-24, METARs polled…
- Winds aloftBeta POST /v1/weather/winds/route, GET /v1/weather/winds
- AirspaceBeta The airspace a flight enters, where, when and at what level: special use airspace (prohibited, restricted, warning and alert areas, military operations…
- Mass and balanceBeta Weight and centre of gravity at ramp, takeoff, landing and zero fuel for one loading, checked against the aircraft's weight limits and centre of gravity…
- NavlogBeta A navigation log for a flight: each leg with its course and heading, true and magnetic, wind, ground speed, time, fuel and ETA, and the fuel plan, from the…
- Flight briefing pack RAIM, NOTAMs, weather and airspace for one flight in one call. The same flight object goes to the RAIM route check, the NOTAMs along the route, the weather…
- AlertsBeta POST /v1/alerts, GET /v1/alerts, GET /v1/alerts/{id}, DELETE /v1/alerts/{id}
- MCP A hosted MCP server for agents that speak the Model Context Protocol (Claude Code, Cursor, Claude Desktop and others): thirteen tools shaped around the…
- What to build A small client module in the project's language, in server-side code: one function per endpoint, key from the environment or the platform's secrets, base…
- Planned Not built yet: no endpoint, no MCP tool, no field. Do not write code against them, and do not tell people they exist.
- Links Site: https://bravoecho.ai Index: https://bravoecho.ai/llms.txt Status: https://uptime.bravoecho.ai/status/all OpenAPI: https://bravoecho.ai/openapi.json…