commitments

Every locked version of one commitment's plan of record

Every locked version of one commitment's plan of record, newest first, with the version that is the budget flagged. Metadata only: the label, who locked it, when, and how many cells it holds.

A version is the plan as it was, not today's forecast wearing its name: nothing in it is recomputed, which is the whole reason two lines exist. budget is the version a variance is measured against, and it is null WITH a reason where no version has been named the budget, never an empty object, which would read as a budget of nothing.

An empty list carries its reason, and it is not one reason: nobody has locked a version, or this organisation cannot hold one yet. The frozen grid itself is a separate read, one version at a time, because a year of weekly reforecasts would make this one a download.

Scope: planning:read.

get/api/v1/commitments/{commitment_id}/money/plan/versions

Request

  • Base URL: https://api.app.tightly.io
  • URL: https://api.app.tightly.io/api/v1/commitments/{commitment_id}/money/plan/versions
  • Auth: HTTP bearer

Path parameters

commitment_idstring required

The commitment's id.

Headers

Tightly-Versionstring
Example:2026-11

The date train to answer on. One train exists today, 2026-11, the one this reference describes and the one every key is minted on, so the call answers on it with or without this header. Send it anyway, so a client built now names its train from the start.

Response

The locked versions of this plan

Changes

No recorded changes to this operation across all 1 revision of this API.