Skip to content
HALOWERK

Finopswerk

maternity pay employer recovery ledger

Computes a conditional UK 2026/27 Statutory Maternity Pay gross budget and employer HMRC recovery for one already eligible employee. 39 weeks: first 6 weeks at 90% of the caller's Average Weekly Earnings (AWE), remaining 33 weeks at min(90% AWE, 194.32 GBP). Recovery is 109% if total Class 1 NI in the last complete tax year before the qualifying week is <= 45000 GBP, otherwise 92%. Returns 24 exact scalars. Gross minus recovery is not net employer cost.

POST https://finops.halowerk.com/v1/maternity-pay-employer-recovery-ledger

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
average_weekly_earnings_nintegerYes
prior_class1_ni_penceintegerYes
weeksintegerYes
captured_awe_domain_narrayYes
amount_denominatorintegerYes
reportobjectYes
Show full input schema
{
  "type": "object",
  "properties": {
    "average_weekly_earnings_n": {
      "type": "integer",
      "minimum": 12900,
      "maximum": 1000000000
    },
    "prior_class1_ni_pence": {
      "type": "integer",
      "minimum": 0,
      "maximum": 100000000
    },
    "weeks": {
      "type": "integer",
      "minimum": 0,
      "maximum": 39
    },
    "captured_awe_domain_n": {
      "type": "array",
      "minItems": 1,
      "maxItems": 2,
      "uniqueItems": true,
      "items": {
        "type": "integer",
        "minimum": 12900,
        "maximum": 1000000000
      }
    },
    "amount_denominator": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "report": {
      "type": "object",
      "minProperties": 24,
      "maxProperties": 24,
      "propertyNames": {
        "enum": [
          "average_weekly_earnings",
          "first_phase_weekly_pay",
          "standard_later_weekly_cap",
          "later_phase_weekly_pay",
          "prefix_week_count",
          "prefix_first_phase_weeks",
          "prefix_later_phase_weeks",
          "prefix_first_phase_gross",
          "prefix_later_phase_gross",
          "prefix_gross_pay",
          "full_first_phase_gross",
          "full_later_phase_gross",
          "full_39_week_gross",
          "remaining_gross_pay",
          "recovery_rate",
          "prefix_hmrc_recoverable",
          "full_hmrc_recoverable",
          "prefix_gross_less_recovery",
          "full_gross_less_recovery",
          "small_employer_indicator",
          "prefix_recovery_excess",
          "prefix_unrecovered_pay",
          "gross_phase_bridge_gap",
          "recovery_cost_bridge_gap"
        ]
      },
      "additionalProperties": {
        "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": [
    "average_weekly_earnings_n",
    "prior_class1_ni_pence",
    "weeks",
    "captured_awe_domain_n",
    "amount_denominator",
    "report"
  ],
  "additionalProperties": false
}

Open original schema

Published input example

{
  "average_weekly_earnings_n": 194320,
  "prior_class1_ni_pence": 4500000,
  "weeks": 7,
  "captured_awe_domain_n": [
    194320
  ],
  "amount_denominator": 9,
  "report": {
    "average_weekly_earnings": {
      "n": "194320",
      "d": "9"
    },
    "first_phase_weekly_pay": {
      "n": "19432",
      "d": "1"
    },
    "standard_later_weekly_cap": {
      "n": "19432",
      "d": "1"
    },
    "later_phase_weekly_pay": {
      "n": "19432",
      "d": "1"
    },
    "prefix_week_count": {
      "n": "7",
      "d": "1"
    },
    "prefix_first_phase_weeks": {
      "n": "6",
      "d": "1"
    },
    "prefix_later_phase_weeks": {
      "n": "1",
      "d": "1"
    },
    "prefix_first_phase_gross": {
      "n": "116592",
      "d": "1"
    },
    "prefix_later_phase_gross": {
      "n": "19432",
      "d": "1"
    },
    "prefix_gross_pay": {
      "n": "136024",
      "d": "1"
    },
    "full_first_phase_gross": {
      "n": "116592",
      "d": "1"
    },
    "full_later_phase_gross": {
      "n": "641256",
      "d": "1"
    },
    "full_39_week_gross": {
      "n": "757848",
      "d": "1"
    },
    "remaining_gross_pay": {
      "n": "621824",
      "d": "1"
    },
    "recovery_rate": {
      "n": "109",
      "d": "100"
    },
    "prefix_hmrc_recoverable": {
      "n": "3706654",
      "d": "25"
    },
    "full_hmrc_recoverable": {
      "n": "20651358",
      "d": "25"
    },
    "prefix_gross_less_recovery": {
      "n": "-306054",
      "d": "25"
    },
    "full_gross_less_recovery": {
      "n": "-1705158",
      "d": "25"
    },
    "small_employer_indicator": {
      "n": "1",
      "d": "1"
    },
    "prefix_recovery_excess": {
      "n": "306054",
      "d": "25"
    },
    "prefix_unrecovered_pay": {
      "n": "0",
      "d": "1"
    },
    "gross_phase_bridge_gap": {
      "n": "0",
      "d": "1"
    },
    "recovery_cost_bridge_gap": {
      "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 โ†’