Get billing coverage

get

https://app.revenium.ai/api/v2/analytics/billing-coverage

Compares the AI cost Revenium metered with what your AI providers billed you, per provider and overall, for the period: how much of each provider's bill the metered usage accounts for (ratio), the billed cost that was not metered (hiddenSpend), and the change from the previous period of the same length (trend). Providers need a connected billing credential to be compared; a provider with metered usage and no billing credential is listed with billingCredentialConnected false and left out of the totals. When the overall ratio cannot be calculated, aggregateRatioUnavailableReason says why.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

period

string

enum

Defaults to 30d

The period to compare, ending today in UTC: 24h, 7d, 30d, 90d, or custom with startDate and endDate. Defaults to 30d.

Allowed:

startDate

string

First day of a custom period, ISO 8601 in UTC, for example 2026-09-01T00:00:00Z. Only its UTC day is used. Required when period is custom, ignored otherwise.

endDate

string

Last day of a custom period, included, ISO 8601 in UTC. At most 366 days after startDate and not in the future. Required when period is custom, ignored otherwise.

provider

string

Narrow the comparison to one provider, for example anthropic. Omit it for every provider.

teamId

string

Hashed id of the team to answer for. Optional. With a user token it may be any team the user belongs to; without it the user's default team answers. An API key always answers for its own team, and naming any other team is refused with 403.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Credentials

Bearer

API Key

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/problem+json

200Get billing coverage

400Bad Request: the request is invalid. code is one of INVALID_INPUT, INVALID_TEAM_ID, VALIDATION_ERROR.

401Unauthorized: the API key or token is missing or invalid. code is UNAUTHORIZED.

403Forbidden: the credential may not make this request. code is one of FORBIDDEN, TEAM_NOT_IN_MEMBERSHIP.

404Not Found: the requested resource does not exist. code is NOT_FOUND.

429Too Many Requests: the rate limit was exceeded. code is RATE_LIMITED.

500Internal Server Error: the request could not be completed. code is one of INTERNAL_ERROR, INTERNAL_SERVER_ERROR.

503Service Unavailable: try again later. code is COVERAGE_UNAVAILABLE.