List costs

GET

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

GET

/v1/costs

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

{
  "object": "string",
  "data": [
    {
      "id": "cost_8Jq3vB6yDs",
      "object": "string",
      "idempotency_key": "string",
      "provider": "string",
      "model": "string",
      "priced_by": "request",
      "timestamp": "2024-01-15T09:30:00Z",
      "livemode": true,
      "created_at": "2024-01-15T09:30:00Z",
      "run_id": "string",
      "customer": "string",
      "agent_id": "string",
      "member_id": "string",
      "team_id": "string",
      "usage": {
        "input_tokens": 1840,
        "output_tokens": 512,
        "cache_read_tokens": 1,
        "cache_write_tokens": 1,
        "reasoning_tokens": 1
      },
      "lines": [
        {
          "unit": "string",
          "quantity": "string",
          "dimensions": {},
          "cost_model": "cm_6bR3xN8vQe",
          "rate_card": "rc_4tG9wK2nPd",
          "rate_card_version": 1,
          "rate_source": "catalog",
          "override": "textco_negotiated",
          "catalog_price": "catp_9cW4hL6rBv",
          "cost": {
            "amount_decimal": "0.042",
            "currency": "usd"
          }
        }
      ],
      "cost": {
        "amount_decimal": "0.042",
        "currency": "usd"
      },
      "warnings": [
        {
          "code": "no_rate_for_event",
          "message": "string"
        }
      ],
      "metadata": {}
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}

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

customer_idstringOptional

Only objects belonging to this customer.

run_idstringOptional

Only costs from this run.

modelstringOptional

Only costs for this model.

created_afterdatetimeOptional

Only objects created at or after this time.

created_beforedatetimeOptional

Only objects created before 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 costs.

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