Provider Billing API ReferenceProvider billing
Export complete metered usage over a half-open UTC window.
GET
/v1/finops/usageAuthorizationBearer <token>
Dedicated read-only token bound to the customer billing account.
In: header
Query Parameters
start*string
Inclusive UTC window start.
Format
date-timeend*string
Exclusive UTC window end.
Format
date-timegranularity*string
Requested native usage bucket width.
Value in
- "1h"
- "1d"
limit?integer
Maximum records in this page.
Range
1 <= value <= 1000Default
1000cursor?string
Opaque cursor returned by the previous page.
Length
1 <= lengthResponse Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://example.com/v1/finops/usage?start=2019-08-24T14%3A15%3A22Z&end=2019-08-24T14%3A15%3A22Z&granularity=1h"{ "data": [ { "x_RecordId": "usage_20260701_model-x_input", "x_RecordUpdatedAt": "2026-07-02T01:05:00Z", "x_Granularity": "1h", "ChargePeriodStart": "2026-07-01T00:00:00Z", "ChargePeriodEnd": "2026-07-01T01:00:00Z", "ServiceProviderName": "Example Inference", "ServiceCategory": "AI and Machine Learning", "ServiceSubcategory": "Generative AI", "ServiceName": "Inference API", "SkuId": "model-x:input", "SkuMeter": "Input Tokens", "ConsumedQuantity": "1250000", "ConsumedUnit": "tokens", "x_UsageType": "input_tokens", "x_ModelId": "model-x", "x_ProjectId": "project_123", "x_ApiKeyId": "key_456", "x_ServiceTier": "standard" } ], "next_cursor": "eyJvZmZzZXQiOjF9", "as_of": "2026-07-02T01:05:00Z", "available_through": "2026-07-02T01:00:00Z"}