# Worthune API

**Canonical:** https://apis.io/apis/worthune/worthune-api/  
**Provider:** Worthune — https://apis.io/providers/worthune/  
**Documentation:** https://worthune.com/docs

Worthune API is published by [Worthune](https://apis.io/providers/worthune/) on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 4 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 4 JSON Schemas.

Worthune API as documented publicly: 22 operations. Contract generated from the documentation by API Evangelist (2026-10-19); not the provider's own document.

## Operations (22)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/book-scan` | POST /api/v1/book-scan — the same coordination sweep across up to 250 households at once |
| GET | `/api/v1/decisions/{id}` | GET /api/v1/decisions/{id} |
| POST | `/api/v1/embed-tokens` | POST /api/v1/embed-tokens — mints a short‑lived, household‑scoped signed token |
| GET | `/api/v1/evals/refinance` | GET /api/v1/evals/refinance |
| POST | `/api/v1/grade/{model}` | Worthune Evals — Ground Truth for Financial AI |
| POST | `/api/v1/households` | POST /api/v1/households — create the document (pass your own importKey and a retried create returns the household it already made) |
| POST | `/api/v1/households/import` | POST /api/v1/households/import — bulk migration, up to 200 households a batch |
| POST | `/api/v1/households/{id}/decisions` | Each strategy returns ranked alternatives with a computed dollar delta against the baseline — every option shown, never just a winner — and each decision car... |
| POST | `/api/v1/households/{id}/project` | Run this yourself |
| GET | `/api/v1/models` | Discover models at GET /api/v1/models |
| GET | `/api/v1/models/{model}` | Three endpoints per model: the JSON contract ( GET /api/v1/models/{model} ) |
| POST | `/api/v1/models/{model}` | Three endpoints per model: execution ( POST /api/v1/models/{model} ) |
| POST | `/api/v1/models/{model}/report` | POST /api/v1/models/{model}/report takes the same JSON inputs as a run and returns a print‑ready HTML document |
| GET | `/api/v1/openapi.json` | The whole surface is described by GET /api/v1/openapi.json |
| GET | `/api/v1/project` | Run the Engine on Your Own Numbers — No Signup, Nothing Stored |
| POST | `/api/v1/project` | POST /api/v1/project — the full projection and optional Monte Carlo on a household document you send |
| GET | `/api/v1/project/examples/retired-couple-spousal` | Run the Engine on Your Own Numbers — No Signup, Nothing Stored |
| POST | `/api/v1/project/examples/retired-couple-spousal` | POST /api/v1/project/examples/retired-couple-spousal |
| POST | `/api/v1/records/verify` | POST /api/v1/records/verify — verify a decision record’s digest |
| GET | `/api/v1/telemetry` | 63 models in the catalog today. |
| POST | `/api/v1/verify` | Documents A run you can hand to a reviewer |
| POST | `/api/v1/verify/emergency-fund` | POST /api/v1/verify/emergency-fund |

## Machine-readable artifacts (6)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/worthune/refs/heads/main/openapi/_ae-authored/worthune-openapi-generated.yml
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/worthune/refs/heads/main/json-schema/worthune-post-api-v1-verify-emergency-fund-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/worthune/refs/heads/main/json-schema/worthune-get-api-v1-project-examples-retired-couple-spousal-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/worthune/refs/heads/main/json-schema/worthune-post-api-v1-households-id-decisions-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/worthune/refs/heads/main/json-schema/worthune-get-api-v1-project-response-schema.json
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/worthune/refs/heads/main/apis.yml

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/worthune/worthune-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/worthune/.