---
url: /api-reference.md
---

# API Reference

This page renders `docs/generated/openapi.json`. That file is generated by `npm run openapi:generate` from the running application and its Zod schemas, verified byte for byte by `npm run openapi:check`, and never edited by hand — so this page always reflects what the service actually exposes, not a snapshot of it. The same file is served as [`/openapi.json`](/openapi.json).

Today that is genuinely small: business routes are served under `/api/v1/...`, but none are documented here yet, because none exist as running endpoints. The two health probes below stay unversioned and unprefixed on purpose — Railway's healthcheck depends on that exact path, and they are deliberately outside the `data` envelope.