Kovara reports what your GPU launches cost: per day, provider, GPU, region, connection and label, with a forecast for the month, budget alerts for organizations, and exports in the FinOps Open Cost and Usage Specification (FOCUS) 1.2 format.
- Your own launches: Workspace → Launches → Costs
- An organization's launches: Organization → Launches → Costs (
/organizations/<id>/costs) - Scripts:
GET /api/v1/costswith a developer key (scopelaunches:read)
How the figures are made
Every cost line is an estimate made by Kovara:
the provider's own live price, recorded when the launch was confirmed (USD per GPU-hour) × the number of GPUs × the hours between Kovara's create request and the recorded termination (or now, while the instance runs)
You pay the provider directly, on your own account, and the provider's invoice is the authority. Differences come from the provider's own billing granularity (per second, per minute or per hour), its billing start (when the instance boots rather than when it was requested), taxes, credits and discounts. A launch whose create failed is never counted.
Lines are split at UTC midnight, so a launch that runs from 22:00 to 02:00 has two lines of two hours each.
Forecast
The month forecast is what has accrued this UTC month plus, for every launch still running, its hourly price for the hours left until its own stop time or the end of the month, whichever comes first.
Labels
Labels are key/value pairs on a launch, such as team=research, project=llm-eval or cost-center=4410.
- Up to 20 per launch. Keys are lowercase, start with a letter and use letters, digits and
. _ - / :(at most 63 characters). Values are text of at most 256 printable characters. - The launch's owner can set them, and so can an Owner or Member of the organization the launch is filed under.
- They never change the launch. They appear on every cost line, as columns in the spreadsheet CSV and as
Tagsin the FOCUS export. - Every change is recorded in the launch's event log.
API: PUT /api/v1/launches/{id}/labels with {"labels": {"team": "research"}}. Sending {} removes them.
Budget alerts (organizations)
An organization's Owners set a monthly budget under Launches → Launch limits. Kovara refuses a launch that would take the month's committed total past it. The committed total is the confirmed maximum total of every launch created this UTC month.
Budget alerts announce thresholds of that same committed total, by default 50%, 80% and 100%:
- Every active Owner gets a notification, which also reaches their delivery channels (webhook, Slack, email).
- Each threshold is announced once a month. When several are passed at once, only the highest is announced.
- Checked every 15 minutes.
Exports
| Format | What it is |
|---|---|
focus | FOCUS 1.2 CSV: one row per cost line, every FOCUS 1.2 column present (empty when Kovara has no value) plus x_ columns |
csv | A spreadsheet CSV with one column per label key. Text that a spreadsheet would run as a formula is prefixed with ' |
json | The report itself |
FOCUS columns as Kovara fills them:
| Column | Value |
|---|---|
BilledCost, EffectiveCost, ListCost, ContractedCost | The estimated cost of the line in USD |
ListUnitPrice, ContractedUnitPrice | The provider's live price per GPU-hour at confirmation |
BillingAccountId, BillingAccountName | Your Kovara provider connection (the provider account the launch ran on) |
BillingCurrency, PricingCurrency | USD |
BillingPeriodStart, BillingPeriodEnd | The UTC calendar month of the line |
ChargePeriodStart, ChargePeriodEnd | The part of the UTC day the instance ran |
ChargeCategory, ChargeFrequency, PricingCategory | Usage, Usage-Based, Standard |
ConsumedQuantity, PricingQuantity | GPU-hours, with ConsumedUnit, PricingUnit and SkuMeter set to GPU-Hours |
InvoiceIssuerName, ProviderName, PublisherName | The GPU provider |
RegionId, RegionName | The permanent Kovara region id and its name |
ResourceId, ResourceName, ResourceType | The provider's instance id (or the Kovara name tag), the name tag, GPU Instance |
ServiceCategory, ServiceName | Compute, GPU Instances |
SkuId | The permanent Kovara offering id |
SubAccountId, SubAccountName | The organization (or your personal account) |
Tags | The launch's labels as a JSON object |
x_CostBasis | States on every row that the figure is an estimate and the provider's invoice is authoritative |
x_KovaraLaunchId, x_KovaraInstanceId, x_ProviderInstanceId, x_GpuModel, x_GpuCount | Kovara identifiers and the GPU |
Commitment discount columns are empty: Kovara records no commitment discounts.
API
curl -H "Authorization: Bearer $KOVARA_KEY" \
"https://www.kovaragrid.com/api/v1/costs?from=2026-11-01&to=2026-11-30&format=focus" -o costs.csvfromandtoare UTC dates (inclusive). The default is the current month to date, and a window spans at most 367 days.- Add
organization_idfor an organization you belong to. - More than 20,000 lines in one window answers
413: choose a shorter window.