> ## Documentation Index
> Fetch the complete documentation index at: https://docs.calmtreasury.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenAPI spec

> Download the machine-readable spec and generate a typed client.

The Calm API ships a machine-readable [OpenAPI 3.1](https://spec.openapis.org/oas/v3.1.0)
description. Point any OpenAPI toolchain at it to generate a typed client,
mocks, or contract tests instead of hand-writing request and response types.

## Download

The spec is served at `https://docs.calmtreasury.xyz/api/openapi.json` — every
operation on this reference, with request bodies, response shapes, security,
and error codes. Point a generator straight at that URL, or save it locally.

<Card title="openapi.json" icon="download" href="https://docs.calmtreasury.xyz/api/openapi.json">
  Download the full OpenAPI 3.1 spec.
</Card>

## What the spec covers

This spec is the **supported surface**: the operations here are the ones you
build against, with a stable request/response contract. Anything not described
here is not a supported integration point, even if you can observe it on the
wire — it can change without notice.

The spec is generated from the API source and enforced in CI, keeping it
aligned with what the server accepts and returns.

<Note>
  If you use the [React SDK](/sdk/react), it already wraps these calls — you
  only need the spec when building a client on another platform or a custom
  integration.
</Note>