Skip to content
HALOWERK

Finopswerk

graded vesting tranche expense

Reconcile an EQUITY-SETTLED employee award with graded SERVICE-ONLY vesting: each instalment has its OWN grant-date per-award fair value and required service duration. All tranches begin service at the same grant date. Caller supplies granted awards, previous/current expected awards that ultimately vest, and two ordered elapsed-service captures. Each tranche cumulative cost=expected count*fixed grant FV*min(elapsed/term,1); period expense=current minus previous, including negative.

POST https://finops.halowerk.com/v1/graded-vesting-tranche-expense

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
previous_serviceintegerYes
current_serviceintegerYes
amount_denominatorintegerYes
tranchesarrayYes
reportobjectYes
Show full input schema
{
  "type": "object",
  "properties": {
    "previous_service": {
      "type": "integer",
      "minimum": 0,
      "maximum": 12
    },
    "current_service": {
      "type": "integer",
      "minimum": 0,
      "maximum": 12
    },
    "amount_denominator": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "tranches": {
      "type": "array",
      "minItems": 2,
      "maxItems": 4,
      "items": {
        "type": "object",
        "properties": {
          "granted": {
            "type": "integer",
            "minimum": 1,
            "maximum": 10000
          },
          "vesting_service": {
            "type": "integer",
            "minimum": 1,
            "maximum": 12
          },
          "grant_fv_n": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000
          },
          "previous_expected": {
            "type": "integer",
            "minimum": 0,
            "maximum": 10000
          },
          "current_expected": {
            "type": "integer",
            "minimum": 0,
            "maximum": 10000
          }
        },
        "required": [
          "granted",
          "vesting_service",
          "grant_fv_n",
          "previous_expected",
          "current_expected"
        ],
        "additionalProperties": false
      }
    },
    "report": {
      "type": "object",
      "properties": {
        "total_current": {
          "type": "object",
          "required": [
            "n",
            "d"
          ],
          "properties": {
            "n": {
              "type": [
                "string",
                "null"
              ],
              "minLength": 1,
              "maxLength": 64
            },
            "d": {
              "type": [
                "string",
                "null"
              ],
              "minLength": 1,
              "maxLength": 64
            }
          },
          "additionalProperties": false
        },
        "total_expense": {
          "type": "object",
          "required": [
            "n",
            "d"
          ],
          "properties": {
            "n": {
              "type": [
                "string",
                "null"
              ],
              "minLength": 1,
              "maxLength": 64
            },
            "d": {
              "type": [
                "string",
                "null"
              ],
              "minLength": 1,
              "maxLength": 64
            }
          },
          "additionalProperties": false
        }
      },
      "required": [
        "total_current",
        "total_expense"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "previous_service",
    "current_service",
    "amount_denominator",
    "tranches",
    "report"
  ],
  "additionalProperties": false
}

Open original schema

Published input example

{
  "previous_service": 1,
  "current_service": 2,
  "amount_denominator": 1,
  "tranches": [
    {
      "granted": 100,
      "vesting_service": 1,
      "grant_fv_n": 2,
      "previous_expected": 100,
      "current_expected": 100
    },
    {
      "granted": 100,
      "vesting_service": 2,
      "grant_fv_n": 3,
      "previous_expected": 100,
      "current_expected": 90
    },
    {
      "granted": 100,
      "vesting_service": 3,
      "grant_fv_n": 6,
      "previous_expected": 100,
      "current_expected": 80
    }
  ],
  "report": {
    "total_current": {
      "n": "790",
      "d": "1"
    },
    "total_expense": {
      "n": "240",
      "d": "1"
    }
  }
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub โ†’