LlmUsageRead

Fields

20 fields

cap_hits · required

integer

covered_usd

number or null

hard_cap_usd

number or null

included_usd

number or null

overage_charge_usd

number or null

overage_rate_usd

number or null

overage_usd

number or null

period_end · required

string (date-time)

period_start · required

string (date-time)

project_id · required

string (uuid)

projected_overage_charge_usd

number or null

projected_overage_usd

number or null

projected_period_cost_usd

number or null

projection_basis

string or null

status

string or null

total_cost_usd · required

number

total_input_tokens · required

integer

total_llm_calls · required

integer

total_output_tokens · required

integer

utilization_pct

number or null

Raw schema (JSON)

{
  "properties": {
    "cap_hits": {
      "title": "Cap Hits",
      "type": "integer"
    },
    "covered_usd": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Covered Usd"
    },
    "hard_cap_usd": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Hard Cap Usd"
    },
    "included_usd": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Included Usd"
    },
    "overage_charge_usd": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Overage Charge Usd"
    },
    "overage_rate_usd": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Overage Rate Usd"
    },
    "overage_usd": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Overage Usd"
    },
    "period_end": {
      "format": "date-time",
      "title": "Period End",
      "type": "string"
    },
    "period_start": {
      "format": "date-time",
      "title": "Period Start",
      "type": "string"
    },
    "project_id": {
      "format": "uuid",
      "title": "Project Id",
      "type": "string"
    },
    "projected_overage_charge_usd": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Projected Overage Charge Usd"
    },
    "projected_overage_usd": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Projected Overage Usd"
    },
    "projected_period_cost_usd": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Projected Period Cost Usd"
    },
    "projection_basis": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Projection Basis"
    },
    "status": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Status"
    },
    "total_cost_usd": {
      "title": "Total Cost Usd",
      "type": "number"
    },
    "total_input_tokens": {
      "title": "Total Input Tokens",
      "type": "integer"
    },
    "total_llm_calls": {
      "title": "Total Llm Calls",
      "type": "integer"
    },
    "total_output_tokens": {
      "title": "Total Output Tokens",
      "type": "integer"
    },
    "utilization_pct": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Utilization Pct"
    }
  },
  "required": [
    "project_id",
    "period_start",
    "period_end",
    "total_cost_usd",
    "total_input_tokens",
    "total_output_tokens",
    "total_llm_calls",
    "cap_hits"
  ],
  "title": "LlmUsageRead",
  "type": "object"
}

Used by endpoints

One endpoint sends or returns this schema, on its own or inside another schema.

• GET /api/v1/projects/{project_id}/llm-usage — Get Current Usage

Used by schemas

No other schema contains this one.

More details

• Specification: OpenAPI JSON