Get Provider Coverage Ratio From Supplied Metered Usage

post

https://api.revenium.ai/profitstream/v2/api/billing/coverage

The coverage ratio of GET /coverage, with the metered half supplied in the body as per-day totals per billing bucket instead of aggregated here. The ratio, its rows and every rule behind them are the GET's; only where the metered totals come from differs. meteredDays must cover the requested period and its prior period of equal length, or the request is rejected with 400.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

period

string

enum

required

Time period for analytics

Allowed:

startDate

string

Filter start date/time in ISO 8601 format.

endDate

string

Filter end date/time in ISO 8601 format.

provider

string

enum

Filter results by AI provider. Omit to include all providers.

usageType

string

enum

Filter by usage type. Omit to include all types.

Allowed:

apiKey

string

Narrow results to a single API key id within the caller's organization, matched exactly. Honoured by /billing/chart, /billing/models, /billing/api-keys and /billing/users; other billing endpoints ignore it. On those four, rows and totals cover only charges stored under that id, so a value that matches no stored charge returns a zero total, never the organization total.

minCost

number

≥ 0

Filter by a starting cost (inclusive).

maxCost

number

≥ 0

Filter by an ending cost (inclusive).

teamId

string

required

ID of the team that owns this data.

Body Params

Metered usage per billing bucket and day, aggregated by the caller, that the coverage ratio compares against provider billing.

meteredDays

object

The per-day metered rows and the span of days they cover.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Credentials

Header

Loading…

Response

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

application/json

application/hal+json

*/*

200Coverage ratio retrieved successfully

400Invalid request parameters or body, including meteredDays that do not cover the requested period and its prior period

401Unauthorized - authentication required

403Forbidden - insufficient permissions

404Not Found

409Conflict

422Unprocessable Content

429Too Many Requests

500Internal server error

504Gateway Timeout