List price rule versions

GET

https://api.runledger.co/v1/price_rules/:price_rule/versions

GET

/v1/price_rules/:price_rule/versions

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

{
  "object": "string",
  "data": [
    {
      "id": "pr_8mK4cT1yWb",
      "object": "string",
      "key": "video_cost_plus",
      "name": "string",
      "version": 1,
      "method": "cost_plus",
      "currency": "usd",
      "on_cost_change": "hold",
      "livemode": true,
      "created_at": "2024-01-15T09:30:00Z",
      "description": "string",
      "effective_from": "2024-01-15T09:30:00Z",
      "basis": "catalog",
      "inputs": [
        {
          "cost_model": "vidlab-v2",
          "unit": "video_seconds",
          "quantity_from": "quantity"
        }
      ],
      "markup_percent": "string",
      "target_margin_percent": "string",
      "rows": [
        {
          "dimensions": {
            "resolution": "1080p"
          },
          "unit_amount_decimal": "20",
          "tier_mode": "graduated",
          "tiers": [
            {
              "unit_amount_decimal": "300",
              "up_to": "200000"
            }
          ]
        }
      ],
      "formula": "string",
      "floor_decimal": "string",
      "cap_decimal": "string",
      "credit_value_decimal": "string",
      "priced_from": [
        {
          "cost_model": "cm_6bR3xN8vQe",
          "rate_card": "rc_4tG9wK2nPd",
          "version": 1
        }
      ],
      "actor": {
        "type": "user",
        "id": "usr_4tN8vB2cXk",
        "name": "Claude Code",
        "on_behalf_of": "usr_4tN8vB2cXk",
        "client": "claude-code"
      }
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}

Every version of one price rule, newest first, each read as the rule under that version: one not in force yet, scheduled with a later effective_from, is included, so a change your customers have notice of can be read before it applies.

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.

Path parameters

price_rulestringRequired

The price rule ID (pr_...) or its key.

Query parameters

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

object"list"

datalist of objects

has_moreboolean

next_cursorstringOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error