List catalog price versions

GET

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

GET

/v1/catalog/prices

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

{
  "object": "string",
  "data": [
    {
      "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
        }
      ]
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}

The versioned prices of catalog models, newest first, including versions that are scheduled to take effect later. Use changed_since to read what changed since you last looked. Each version names its source and the date it takes effect. 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

catalog_modelstringOptional

Only versions of this catalog model (catm_...).

providerstringOptional

Only versions for models of this provider key.

statusenumOptional

Only versions with this status.

Allowed values:

changed_sincedatetimeOptional

Only versions Runledger published at or after this time.

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 price versions.

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