Get Project Usage
Retrieve credit usage, subscription details, and per-service request counts for a project within the current credit cycle.
Overview
Returns a complete picture of a project’s credit consumption for the current credit cycle, including credits remaining, subscription plan details, and a breakdown of requests by service type (RPC, DAS, gRPC, WebSocket, etc.). All credit figures are scoped to thecreditCycle — the window credits accrue and reset against, derived from the subscription’s billing anchor. Every project has one, including free plans. The subscriptionDetails.billingCycle is the invoicing window; it is informational and null on free plans, which are never invoiced.
Request Parameters
Response Fields
YYYY-MM-DD format (UTC).YYYY-MM-DD format (UTC).null on free plans, which are never invoiced. On paid plans this normally matches creditCycle.YYYY-MM-DD format.YYYY-MM-DD format."business", "professional").creditsUsed after rounding.laserstreamGrpc, laserstreamWebsocket) do not appear here — see dataTransfer. Fields: rpc, enhancedApi, walletApi, das, webhooks, preConfirmations, archival, photon, other.credits but never in requests. Fields: laserstreamGrpc, laserstreamWebsocket.Request Parameters
Authorizations
API key passed as a query parameter.
Path Parameters
The project ID to retrieve usage for. Must match the project associated with the API key.
"a1b2c3d4-e5f6-7890-abcd-ef1234567890"
Response
Project usage retrieved successfully.
Number of credits remaining in the current credit cycle. Calculated as creditsLimit - regularCreditsUsed, floored at 0.
487500
Total credits consumed in the current credit cycle, including both regular and prepaid credits.
12500
Number of prepaid credits remaining.
50000
Number of prepaid credits consumed in the current credit cycle.
0
The window every credit figure in this response is scoped to — the period credits accrue and reset against, derived from the subscription's billing anchor. Always present, for every plan, including free plans that are never invoiced.
Details about the project's subscription plan and invoicing cycle.
Per-product credit consumption for the current credit cycle, in whole credits.
Covers every product. Values are accumulated raw and rounded once at the end to
match billing, so per-product credits may not sum exactly to creditsUsed after
rounding.
Request counts for the current credit cycle, for request-metered products only.
The bandwidth-metered LaserStream products (laserstreamGrpc, laserstreamWebsocket)
do not appear here — see dataTransfer.
Bytes transferred for the current credit cycle, for the bandwidth-metered
LaserStream products only. These products are billed by data transferred, not
request count, so they appear here and in credits but never in requests.