billing

List metered usage events (the A2 usage ledger)

Every metered billing event, newest-first, with attribution: featureId, amount, the project/job that produced it, and the event's LIST price in USD (the invoice may zero it inside a plan allowance). Filter by projectId, jobId, and/or a [from, to) epoch-ms period. Events appear moments after the job's success terminal (the meter is scheduler-dispatched).

get/v1/usage

Request

  • Base URL: https://api.cueframe.ai
  • URL: https://api.cueframe.ai/v1/usage
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.cueframe.ai/api/auth/mcp/authorize, token URL https://api.cueframe.ai/api/auth/mcp/token, scopes: billing:read)
    • API key in header PAYMENT-SIGNATURE

Query parameters

limitinteger

Page size (1..100), default 20. Out-of-range or unparseable clamps into the range.

afterstring

Opaque cursor from the previous page's pagination.nextCursor. Forward-only.

projectIdstring

Only events attributed to this project.

jobIdstring

Only events produced by this job — how to answer "did my failed render post a charge?" for one run.

frominteger

Period start, epoch milliseconds, INCLUSIVE.

tointeger

Period end, epoch milliseconds, EXCLUSIVE.

Response

Paginated usage events.

Changes

No recorded changes to this operation across all 1 revision of this API.