Skip to content

GET /v1/openapi.json

Method and path GET /v1/openapi.json
Key not needed
Response an OpenAPI 3.1 document
Lean OpenAPI getOpenApi
Full contract getOpenApi

Available now The served document describes the lean v1 routes as deployed. Point code generators, Postman, Insomnia or Swagger UI at it:

Terminal window
curl -s -o openapi.json https://api.satellitedata.net/v1/openapi.json

The landing page links to it with rel: service-desc. Its info.version is 1.0.0-lean.1.

The same document is browsable on this site: Lean v1, available now (interactive).

The full v1 contract on this site is generated from the design’s OpenAPI document: 31 operations across phases P1 to P4. Each operation carries x-phase, the build phase it ships in, and x-units, its planned metering formula. The document also carries x-quotas (tiers), x-limits (hard caps) and x-units-model.

Routes in the full contract that lean v1 does not serve answer 404 not-found until their phase ships.