List models

List models, ordered by handle. Returns a cursor-paginated page even when the result fits — clients should treat the shape as stable and opaque-cursor.

Without namespace, the listing is scoped to the public u22a8 namespace. Pass namespace=<name> to list elsewhere — it must be a namespace your key owns, or one of the public ones. Filter by state (draft|busy|ready|failed|archived) and kind (scoring only at launch).

GET /models

cURL

cURL

curl "https://u22a8.ai/v1/models?limit=20" \
  -H "Authorization: Bearer $U22A8_API_KEY"

200

{
  "items": [
    {
      "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"
      }
    }
  ],
  "limit": 123,
  "next_cursor": "<string>"
}

Without a namespace query parameter the listing covers the public u22a8 catalog. Pass namespace=<name> to list a namespace your key owns. Results are cursor-paginated: follow next_cursor until it is null.

Authorizations

Authorization · string · header · required

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

Query Parameters

limit · integer · default: 50

Required range: 1 <= x <= 250

cursor · string | null

namespace · string | null

state · string | null

kind · string | null

Response

200

application/json

Successful Response

items · ModelDetail · object[] · required

Show child attributes

limit · integer · required

Page size used for this response.

next_cursor · string | null

Opaque cursor for the next page; null when exhausted.