List catalog models

GET

https://api.runledger.co/v1/catalog/models

GET

/v1/catalog/models

curl https://api.runledger.co/v1/catalog/models \
     -H "Authorization: Bearer <api_key>"

{
  "object": "string",
  "data": [
    {
      "id": "catm_5xT7qD2mKa",
      "object": "string",
      "provider": "vidlab",
      "model": "vidlab-v2",
      "name": "Vidlab v2 video",
      "status": "active",
      "units": [
        {
          "unit": "video_seconds",
          "controlled_by": "customer",
          "description": "string"
        }
      ],
      "dimensions": [
        {
          "key": "resolution",
          "controlled_by": "customer",
          "values": [
            "720p",
            "1080p"
          ],
          "description": "string"
        }
      ],
      "last_verified_at": "2024-01-15T09:30:00Z",
      "kind": "text",
      "current_price": "string",
      "current_price_version": 1,
      "price": {
        "id": "catp_9cW4hL6rBv",
        "object": "string",
        "catalog_model": "catm_5xT7qD2mKa",
        "version": 1,
        "status": "scheduled",
        "currency": "usd",
        "rates": [
          {
            "unit": "video_seconds",
            "per": "1",
            "unit_amount_decimal": "12",
            "dimensions": {
              "resolution": "1080p"
            },
            "tier_mode": "graduated",
            "tiers": [
              {
                "unit_amount_decimal": "300",
                "up_to": "200000"
              }
            ]
          }
        ],
        "effective_from": "2024-01-15T09:30:00Z",
        "as_of": "2026-10-20",
        "source_url": "https://vidlab.example/pricing",
        "published_at": "2024-01-15T09:30:00Z",
        "last_verified_at": "2024-01-15T09:30:00Z",
        "effective_to": "2024-01-15T09:30:00Z",
        "source_reference": "Vidlab pricing page, read 20 October 2026",
        "changes": [
          {
            "path": "outcome_definitions.chat_resolution.confirmation_window",
            "before": null,
            "after": null
          }
        ]
      },
      "updated_at": "2024-01-15T09:30:00Z"
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}

The provider models in the catalog, with the units and dimensions each is priced in and the price version in force. Filter by provider, kind or unit to find the model a piece of code calls. A model that isn’t listed isn’t covered by the freshness target and needs a custom cost model. Needs config:read.

Authentication

AuthorizationBearer

A secret key (rl_sk_test_..., rl_sk_live_...) or a restricted key with limited scopes (rl_rk_test_..., rl_rk_live_...). A restricted key can carry agent: true and an expires_at, and is what a coding agent should hold. Keys end in a checksum so secret scanners can recognize them. People create, roll and revoke keys in the dashboard; GET /v1/api_keys lists them, masked.

Query parameters

providerstringOptional

Only models from this provider key.

kindenumOptional

Only this kind of model.

unitstringOptional

Only models priced in this unit, such as video_seconds.

statusenumOptional

Only models with this status. Default active.

Allowed values:

limitintegerOptional1-100Defaults to 20

Maximum number of objects to return, from 1 to 100.

cursorstringOptional

The next_cursor from the previous page.

Response

A page of catalog models.

object"list"

datalist of objects

has_moreboolean

next_cursorstringOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

500

Internal Server Error