Skip to content
HALOWERK

Finopswerk

equity award modification cost floor

Reconstructs one equity-settled employee award modification with original grant-date cost as floor plus only positive incremental fair value, recognized on distinct original and remaining service bases. Original total = awards * grantFV; incremental = awards * max(afterModFV - beforeModFV, 0), both at the modification date. Returns 13 four-year vectors of service fractions, cost and expense. The caller establishes equity classification and reliable unit FVs.

POST https://finops.halowerk.com/v1/equity-award-modification-cost-floor

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
awardsintegerYes
vesting_yearsintegerYes
modification_after_yearintegerYes
grant_fv_nintegerYes
before_mod_fv_nintegerYes
after_mod_fv_domain_narrayYes
amount_denominatorintegerYes
reportobjectYes
Show full input schema
{
  "type": "object",
  "properties": {
    "awards": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "vesting_years": {
      "type": "integer",
      "minimum": 1,
      "maximum": 4
    },
    "modification_after_year": {
      "type": "integer",
      "minimum": 0,
      "maximum": 3
    },
    "grant_fv_n": {
      "type": "integer",
      "minimum": 0,
      "maximum": 10000
    },
    "before_mod_fv_n": {
      "type": "integer",
      "minimum": 0,
      "maximum": 10000
    },
    "after_mod_fv_domain_n": {
      "type": "array",
      "minItems": 1,
      "maxItems": 2,
      "uniqueItems": true,
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 10000
      }
    },
    "amount_denominator": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "report": {
      "type": "object",
      "minProperties": 13,
      "maxProperties": 13,
      "propertyNames": {
        "enum": [
          "original_service",
          "modified_service",
          "original_fraction",
          "incremental_fraction",
          "original_total",
          "incremental_total",
          "original_cumulative",
          "incremental_cumulative",
          "total_cumulative",
          "original_expense",
          "incremental_expense",
          "total_expense",
          "cost_bridge_gap"
        ]
      },
      "additionalProperties": {
        "type": "array",
        "minItems": 4,
        "maxItems": 4,
        "items": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "n",
            "d"
          ],
          "properties": {
            "n": {
              "type": [
                "string",
                "null"
              ],
              "minLength": 1,
              "maxLength": 64
            },
            "d": {
              "type": [
                "string",
                "null"
              ],
              "minLength": 1,
              "maxLength": 64
            }
          }
        }
      }
    }
  },
  "required": [
    "awards",
    "vesting_years",
    "modification_after_year",
    "grant_fv_n",
    "before_mod_fv_n",
    "after_mod_fv_domain_n",
    "amount_denominator",
    "report"
  ],
  "additionalProperties": false
}

Open original schema

Published input example

{
  "awards": 1,
  "vesting_years": 3,
  "modification_after_year": 1,
  "grant_fv_n": 1,
  "before_mod_fv_n": 2,
  "after_mod_fv_domain_n": [
    3
  ],
  "amount_denominator": 7,
  "report": {
    "original_service": [
      {
        "n": "1",
        "d": "1"
      },
      {
        "n": "2",
        "d": "1"
      },
      {
        "n": "3",
        "d": "1"
      },
      {
        "n": "3",
        "d": "1"
      }
    ],
    "modified_service": [
      {
        "n": "0",
        "d": "1"
      },
      {
        "n": "1",
        "d": "1"
      },
      {
        "n": "2",
        "d": "1"
      },
      {
        "n": "2",
        "d": "1"
      }
    ],
    "original_fraction": [
      {
        "n": "1",
        "d": "3"
      },
      {
        "n": "2",
        "d": "3"
      },
      {
        "n": "1",
        "d": "1"
      },
      {
        "n": "1",
        "d": "1"
      }
    ],
    "incremental_fraction": [
      {
        "n": "0",
        "d": "1"
      },
      {
        "n": "1",
        "d": "2"
      },
      {
        "n": "1",
        "d": "1"
      },
      {
        "n": "1",
        "d": "1"
      }
    ],
    "original_total": [
      {
        "n": "1",
        "d": "7"
      },
      {
        "n": "1",
        "d": "7"
      },
      {
        "n": "1",
        "d": "7"
      },
      {
        "n": "1",
        "d": "7"
      }
    ],
    "incremental_total": [
      {
        "n": "1",
        "d": "7"
      },
      {
        "n": "1",
        "d": "7"
      },
      {
        "n": "1",
        "d": "7"
      },
      {
        "n": "1",
        "d": "7"
      }
    ],
    "original_cumulative": [
      {
        "n": "1",
        "d": "21"
      },
      {
        "n": "2",
        "d": "21"
      },
      {
        "n": "1",
        "d": "7"
      },
      {
        "n": "1",
        "d": "7"
      }
    ],
    "incremental_cumulative": [
      {
        "n": "0",
        "d": "1"
      },
      {
        "n": "1",
        "d": "14"
      },
      {
        "n": "1",
        "d": "7"
      },
      {
        "n": "1",
        "d": "7"
      }
    ],
    "total_cumulative": [
      {
        "n": "1",
        "d": "21"
      },
      {
        "n": "1",
        "d": "6"
      },
      {
        "n": "2",
        "d": "7"
      },
      {
        "n": "2",
        "d": "7"
      }
    ],
    "original_expense": [
      {
        "n": "1",
        "d": "21"
      },
      {
        "n": "1",
        "d": "21"
      },
      {
        "n": "1",
        "d": "21"
      },
      {
        "n": "0",
        "d": "1"
      }
    ],
    "incremental_expense": [
      {
        "n": "0",
        "d": "1"
      },
      {
        "n": "1",
        "d": "14"
      },
      {
        "n": "1",
        "d": "14"
      },
      {
        "n": "0",
        "d": "1"
      }
    ],
    "total_expense": [
      {
        "n": "1",
        "d": "21"
      },
      {
        "n": "5",
        "d": "42"
      },
      {
        "n": "5",
        "d": "42"
      },
      {
        "n": "0",
        "d": "1"
      }
    ],
    "cost_bridge_gap": [
      {
        "n": "0",
        "d": "1"
      },
      {
        "n": "0",
        "d": "1"
      },
      {
        "n": "0",
        "d": "1"
      },
      {
        "n": "0",
        "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 โ†’