---
title: "Full specification (markdown)"
method: GET
path: "/api/v1/models/{model}/spec"
tags: ["models"]
---

# Full specification (markdown)

`GET /api/v1/models/{model}/spec`

## Request

- Base URL: `https://worthune.com`
- URL: `https://worthune.com/api/v1/models/{model}/spec`
- Auth: one of:
  - none
  - HTTP bearer
  - API key in header `X-Api-Key`

The authoritative contract: inputs with units, exact computation, assumptions, exclusions, known issues and changelog. Fully public for emergency-fund, relocation, side-business; the rest of the catalog's specs come with a paid key.

## Response `200`

The spec as text/markdown (cache-control public for sample models, private otherwise).

## Other responses

- `402`: A paid model (or its spec / dataset / grading) was called without a key, or with an unrecognized or revoked key. Free without a key: emergency-fund, relocation, side-business.
- `404`: Unknown model.
- `429`: Hourly per-org stateful quota, a per-route durable limit, or the 120 requests/minute per-IP burst backstop.

---

[API](https://skmtc.dev/worthune/apis/worthune-api.md) · [All operations](https://skmtc.dev/worthune/apis/worthune-api/llms.txt) · [OpenAPI document](https://skmtc.dev/worthune/apis/worthune-api/revisions/9f2241072555?raw)