Get a model

Returns the model’s structured detail as JSON. Set Accept: text/markdown to fetch the model card instead — the same markdown the MCP server exposes as the model’s resource. Reading a model is never gated by its additional terms; the card is how a caller reviews those terms.

GET /models/{handle}

cURL

cURL

curl https://u22a8.ai/v1/models/u22a8.commit-message \
  -H "Authorization: Bearer $U22A8_API_KEY"

200

{
  "handle": "<string>",
  "scoring_method": "<string>",
  "description": "",
  "state": "ready",
  "kind": "scoring",
  "traits": [
    "<string>"
  ],
  "current_version_id": 123,
  "version_no": 123,
  "version_tags": [
    "<string>"
  ],
  "zero_data_retention": false,
  "last_operation": {
    "kind": "train",
    "run_id": "run_abc",
    "started_at": "2026-05-19T12:00:00Z",
    "status": "succeeded"
  }
}

Returns JSON by default. Set Accept: text/markdown to fetch the model card — a human-readable summary of the model, its traits, and any additional terms. It is the same markdown the MCP server serves as the model’s resource.

Authorizations

Authorization · string · header · required

API key issued in the platform console, sent as Authorization: Bearer <key>.

Path Parameters

handle · string · required

Model handle, e.g. 'u22a8.technical-writing'.

Example:

"u22a8.technical-writing"

Response

200

application/json

Successful Response

handle · string · required

Example:

"u22a8.compelling-readme"

scoring_method · string · required

Example:

"balanced_cosine"

description · string · default: ""

state · string · default: ready

Lifecycle state: draft, busy, ready, failed, or archived. busy is the transient state while an asynchronous operation (training, discovery, retraining) runs — see last_operation for which one.

Examples:

"draft"

"busy"

"ready"

"failed"

"archived"

kind · string · default: scoring

Example:

"scoring"

traits · string[]

Example:

["Clarity", "Flow"]

current_version_id · integer | null

Identifier of the version currently serving scores. Null before the first successful train; updates on every successful train or retrain.

version_no · integer | null

Version number of the active snapshot — the integer behind vN. Null before the first train.

version_tags · string[]

User-named tags pointing at the active version.

zero_data_retention · boolean · default: false

Whether zero-data-retention is enabled. When on, submitted content is not retained.

last_operation · Last Operation · object

The most recent lifecycle operation: {kind, status, started_at, run_id?, progress?, error?}. kind identifies what the model is doing while busy (e.g. train, discover, retrain). Null on models that have never run an operation.

Example:

{
  "kind": "train",
  "run_id": "run_abc",
  "started_at": "2026-05-19T12:00:00Z",
  "status": "succeeded"
}