# The API serves its own spec

`GET /v1/openapi.yaml` and `/v1/openapi.json` serve the public contract — the same document this reference is built from, no API key needed.

Sep 3, 2026 · New

The API now serves its own contract at `GET /v1/openapi.yaml` and `GET /v1/openapi.json` — byte for byte the document this reference is generated from, so a client generated from the API and a client generated from the docs are the same client. Only the public spec is served.

## What else changed

- **No API key required.** It is the contract, not your data.
- **Deliberately absent from the spec it serves**, so a generated client does not grow a method for downloading its own definition. `/openapi.yaml` and `/openapi.json` answer the same document.

## Endpoints

- `GET /v1/openapi.yaml` — The public contract, as YAML
- `GET /v1/openapi.json` — The public contract, as JSON

## Where to go next

- [SDKs](/sdks/node)

---

Full OpenAPI spec: https://docs.beel.es/api/openapi