← Back to product·Simulmedia Switchboard Docs · v1 draft·Guides: for buyers / Upfront commitments
Guides: for buyers

Upfront commitments

An upfront commitment lives as an agreement-level object: commit a budget ahead of the season, lock rates early, then place orders that draw against it.

"upfront": { "uf_id": "uf_2027_acme", "committed_gross": 8000000,
  "drawn_gross": 2450000, "options": { "q3_cancel_pct": 0.25, "exercise_by": "2027-05-01" } }
  • Draw-down orders reference uf_id; pricing leverage from the commitment is baked into the agreement-scoped card.
  • Options and cancellation windows are enforced as validations with dates, not remembered in email.
  • Pacing is queryable (GET /v1/agreements/{id}/pacing), so both sides watch the same drawdown number.