List cost models

GET

https://api.runledger.co/v1/cost_models

GET

/v1/cost_models

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

{
  "object": "string",
  "data": [
    {
      "id": "cm_6bR3xN8vQe",
      "object": "string",
      "key": "vidlab-v2",
      "name": "string",
      "source": "catalog",
      "provider": "vidlab",
      "model": "vidlab-v2",
      "status": "active",
      "units": [
        {
          "unit": "video_seconds",
          "controlled_by": "customer",
          "description": "string"
        }
      ],
      "dimensions": [
        {
          "key": "resolution",
          "controlled_by": "customer",
          "values": [
            "720p",
            "1080p"
          ],
          "description": "string"
        }
      ],
      "livemode": true,
      "created_at": "2024-01-15T09:30:00Z",
      "catalog_model": "catm_5xT7qD2mKa",
      "overrides": [
        {
          "key": "textco_negotiated",
          "unit": "input_tokens",
          "dimensions": {
            "resolution": "1080p"
          },
          "discount_percent": "0.2",
          "unit_amount_decimal": "10",
          "per": "1",
          "effective_from": "2024-01-15T09:30:00Z",
          "effective_to": "2024-01-15T09:30:00Z",
          "category": "negotiated_discount",
          "reason": "Negotiated 20% off to 31 December 2026"
        }
      ],
      "kind": "text",
      "active_rate_card": "string",
      "active_rate_card_version": 1,
      "metadata": {},
      "actor": {
        "type": "user",
        "id": "usr_4tN8vB2cXk",
        "name": "Claude Code",
        "on_behalf_of": "usr_4tN8vB2cXk",
        "client": "claude-code"
      }
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}

Newest first.

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.

sourceenumOptional

Only cost models taking their rates from the catalog, or only custom ones.

Allowed values:

kindenumOptional

Only this kind of model.

statusenumOptional

Only cost models with this status.

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 cost 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