Cash

1 read, no writes, on train 2026-11. Scopes: cash:read.

Operation	Method	Scope	Path
The open buy on each supplier's terms clock	GET	cash:read	/api/v1/commitments/cash-gate

The open buy on each supplier's terms clock

GET /api/v1/commitments/cash-gate

Scopes: cash:read

Fifty-two retail weeks of merchandise cash: what comes in from what sold and, on the weeks ahead, from the plan of record; what goes out as the open buy lands on each supplier's own billing lag; the balance walked against a declared floor; and the levers that would move the tightest weeks.

Optional	In	What it is
include_projection	query	Set false for a buying-plan-only read.
commitment_id	query	Narrows NOTHING.
weeks	query	How many weeks of the ladder to serve, from the first.
scenario	query	A company scenario's id.
Tightly-Version	header	The date train to answer on.

curl "https://api.app.tightly.io/api/v1/commitments/cash-gate" \
  -H "Authorization: Bearer $TIGHTLY_API_KEY"

What it answers

{
  "data": {
    "as_of": "2026-09-05",
    "cash_floor_usd": 2500000,
    "committed_in_source": "order_book",
    "computed_at": "2026-09-05T06:12:44Z",
    "groups": [
      {
        "key": "sup_2f18a0",
        "name": "Porto Knitworks",
        "open_buy_usd": 3120000,
        "terms_days": 45,
        "terms_measured_from": "11 billed orders",
        "terms_source": "measured",
        "weekly_draw_usd": [
          902400,
          1841000
        ]
      }
    ],
    "levers": [
      {
        "buy_effect_usd": 0,
        "key": "porto_to_90",
        "name": "Move Porto Knitworks to 90-day terms",
        "reason": null,
        "releases": [
          {
            "cash_usd": 1841000,
            "group_key": "sup_2f18a0"
          }
        ],
        "reversible": true,
        "why": "Two weeks fall below the floor on its bills alone."
      }
    ],
    "not_measured": [],
    "opening_balance_usd": 4820000,
    "planned_out_coverage": {
      "cap": 6
      …
    }
  }
}

What it refuses

• 401 key_invalid: "The API key is not valid." No usable key: malformed, unknown, revoked, expired or stopped. One refusal covers all five, telling a caller which is which maps the surface for them. A request with no Authorization header at all is refused 400 before any key is looked for.
• 403 plan_excludes: "This organisation's plan does not include Commitments. It is sold with Pro." The key may not reach this operation. plan_excludes when Cash is sold with Pro and this organisation's plan does not include it; scope_missing when the key does not hold Cash; organization_mismatch when the path names an organisation that is not the key's; ip_not_allowed when the caller's address is outside the key's allowlist.
• 429

Try it in the reference