Format run receipt: $14.96 billed against a $120 cap, field by field

The documented Format run receipt shows billable_amount_usd_micros 14,959,638 and a cap of 120,000,000. How to read micros, and what unused cap means.

4 min readSume
All posts

The example webhook in the Format run docs carries a usage block: billable_amount_usd_micros is 14959638 and generation_spend_cap_usd_micros is 120000000. Both are USD micros, so divide by 1,000,000.

That is $14.96 billed against a $120 cap. The cap is a ceiling the run may not exceed, not a charge. The remaining $105.04 stays in the wallet.

The usage block in dollars (read 2026-10-07)
FieldMicrosDollars
billable_amount_usd_micros14,959,638$14.96
generation_spend_cap_usd_micros120,000,000$120.00
Headroom (cap minus billed)105,040,362$105.04

Why the cap matters more than the bill

A Format run is allowed to spend up to its cap. The docs set the default cap at $400 and the maximum at $500, so a request without an explicit smaller cap can legally reach $400. The receipt example shows the sensible habit: a $120 cap for a job that landed at about an eighth of it.

The same payload is returned by GET /v1/format-runs/{run_id}, so one parser reads both the webhook and a poll.

micros = 14959638
print(f"${micros / 1_000_000:.2f}")

Sources

Related posts

More in Formats

All Formats posts

Written by Sume