---
title: "Sourced-constants registry"
method: GET
path: "/api/v1/facts"
tags: ["facts"]
---

# Sourced-constants registry

`GET /api/v1/facts`

## Request

- Base URL: `https://worthune.com`
- URL: `https://worthune.com/api/v1/facts`
- Auth: none required

Every government-defined constant the models consume, with primary source, period, check date and an honest status. Cached (s-maxage 3600).

## Response `200`

The registry.

- object
  - `ok` unknown, required
  - `description` string, required
  - `count` integer, required
  - `facts` Fact[], required
    - `id` string, required
    - `label` string, required
    - `value` number, required
    - `unit` 'USD' | 'ratio' | 'years', required
    - `period` string, required
    - `jurisdiction` 'US-federal' | 'US-state', required
    - `source` object, required
      - `name` string, required
      - `url` string, uri
    - `verifiedOn` string, date, required
    - `status` 'verified' | 'repo-asserted' | 'stale-in-use' | 'historical', required: Computed at request time: "verified" demotes itself to "repo-asserted" once the check date ages past the review interval.
    - `notes` string
  - `docs` string, required

## Other responses

- `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)