Look up UK National Minimum Wage API
Return the official GOV.UK National Minimum / Living Wage hourly rate for a date and age/apprentice category from vendored rate rows.
The Look up UK National Minimum Wage operation is part of the Minimum Wage Holiday Calendar API on BRAINIAC.software. Return the official GOV.UK National Minimum / Living Wage hourly rate for a date and age/apprentice category from vendored rate rows. It is exposed as POST /api/v1/labour-tax/uk-minimum-wage-lookup and priced at $0.01 USDC on Base. Payment uses the x402 exact scheme: an unpaid call returns HTTP 402 with payment requirements; after paying the exact USDC amount, retry the same request with a payment-signature header and Idempotency-Key. No account and no API key are required. Data sources for this product: GOV.UK National Minimum Wage rates US DOL WHD federal minimum wage GOV.UK holiday entitlement guidance IANA Time Zone Database via Intl GOV.UK bank holidays (vendored snapshot, OGL v3.0) and 5 U.S.C. 6103 / US OPM federal holidays HMRC rates and thresholds for employers 2026 to 2027; GOV.UK SSP, maternity pay and income tax rates IRS Publication 15-T (2026) Worksheet 1A and Annual Percentage Method tables Home Office Register of licensed sponsors: workers (vendored CSV, 2026-11-12, OGL v3.0) Limitations: Results are calculations from published tables, not tax, immigration, or employment advice. UK statutory pay and PAYE/NI cover tax year 2026-27 only; PAYE/NI is a constant-pay estimate (no cumulative tables, K codes, student loans or pension). NI categories other than A and M are best-effort. US withholding covers IRS Pub 15-T 2026 only (no nonresident-alien adjustment, no state tables, no FICA); US state minimum wage, LCA/H-1B and state withholding endpoints from issue #83 are not included. Bank holidays cover 2019-2028 (England & Wales, Scotland, Northern Ireland) from the vendored snapshot; US federal holidays are computed for 1971-2100. The sponsor register is a vendored snapshot of current licence holders; NOT_FOUND does not prove a licence was never held. uk-soc2020-search is not yet available (ONS SOC 2020 coding index not vendored). Outputs are compliance prechecks, drafts, or data lookups for human review. They are not official determinations, legal advice, identity confirmation, or certified filings. Related operations in this group include Look up US federal minimum wage, Calculate UK statutory holiday entitlement, Convert a timestamp between IANA time zones, Business day calendar (UK/US). Open the group documentation for the full request schema, field notes, and response examples before integrating.
/api/v1/labour-tax/uk-minimum-wage-lookupExample request
curl -i -X POST "https://www.brainiac.software/api/v1/labour-tax/uk-minimum-wage-lookup" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"asOf": "2026-05-01",
"category": "age_21_plus"
}
JSONAn unpaid probe returns HTTP 402 with x402 payment requirements. After paying the exact USDC amount on Base, retry the identical request with a payment-signature header.
FAQ
- Do I need an API key? No. Pay the listed USDC amount with x402.
- What network? Base (eip155:8453), USDC.
- Is this an official determination? No. Results are for human review against the cited sources.
Related operations
- Look up US federal minimum wage — $0.02 USDC
- Calculate UK statutory holiday entitlement — $0.02 USDC
- Convert a timestamp between IANA time zones — $0.01 USDC
- Business day calendar (UK/US) — $0.02 USDC