Report a bill

Send a day of your Google bill and get each hour and model compared.

Compares one window of an organisation's bill with what was recorded for it, and stores the result.

The lines are the whole bill for billedBy in the window: reporting the same window again replaces what was stored for it, so a provider's later correction is sent the same way as the first report, and a group no longer on the bill is removed. Each recorded call in a group that matches carries its share of the group's bill as Activity.billed_cost_micros; a call in a group that does not match carries none.

Takes a recording key: on the API keys page, a key for An agent covering the whole organisation. A reading key is refused.

Request

  • POST /v1/organisations/{organisation}/reconciliations:reportBill

Parameters

Name In Type Required What it is
body body object yes

Response

Field Type What it is
reconciliations list of object The groups the window was compared in, oldest first.

Each item of the list

Field Type What it is
name string The resource name of the reconciliation.
billedBy string Who billed for the calls, as Activity.billed_by names it, e.g. VERTEX_AI, OPENAI, ANTHROPIC.
environment string The environment the calls were made in, as the report that produced this group named it.
billingAccount string The account the bill line was charged to, as the provider names it: a Google Cloud project id, an OpenAI project or api key, an Anthropic workspace.
startTime timestamp The start of the window the bill line covers: an hour for Google, a day for OpenAI and Anthropic.
endTime timestamp The end of that window, exclusive.
model string The model, as the rate card names it, read from the bill's own product name.
agent string The agent that made every recorded call in the group.
component string The component that made every recorded call in the group, in the form a billing label stores it.
billedCostMicros int64 as string What the bill charged for the group, in millionths of a US dollar, after credits and converted from the bill's currency.
estimatedCostMicros int64 as string What Agent Pulse estimated for the calls it recorded in the group, in millionths of a US dollar.
activityCount int64 as string How many recorded calls fell in the group.
billedTokens object The tokens the bill charged for, by kind.
recordedTokens object The tokens Agent Pulse recorded for the same group, by kind.
result enum How the two compared.
readTime timestamp When the bill holding this group was last reported.

The OpenAPI document has every field. All methods.