# Pay, Tax & Employment Calendars API > Look up UK/US minimum wage tables, calculate UK holiday entitlement and statutory pay, estimate UK PAYE/NI and US federal withholding, convert IANA time zones, search the UK licensed sponsor register, and resolve UK/US business days from vendored official holiday data. Each paid operation uses a fixed USDC price on Base with the x402 exact scheme. Unpaid GET, HEAD, and POST return 402 payment terms (POST validates the body only after payment terms are satisfied). A request that carries payment-signature is not yet charged: settlement happens only after a successful (2xx) result. HTTP 4xx/5xx are not charged. Coverage bodies with status complete, partial, or failed all return HTTP 200 and are charged at the full listed price. Settled 2xx responses include a payment-response header; 4xx/5xx do not. Follow https://www.brainiac.software/agent-instructions.txt for install, payment pins, idempotency, and billing rules. - Product: https://www.brainiac.software/api/labour-tax - Docs: https://www.brainiac.software/api/labour-tax/docs - OpenAPI: https://www.brainiac.software/api/labour-tax/openapi.json - Contact: support@brainiac.software (https://www.brainiac.software/contact) ## Operations ### POST /api/v1/labour-tax/uk-minimum-wage-lookup $0.01 USDC. Return the official GOV.UK National Minimum / Living Wage hourly rate for a date and age/apprentice category from vendored rate rows. Inputs: asOf, category Docs: https://www.brainiac.software/api/labour-tax/docs#labour-tax-uk-minimum-wage-lookup Example request: ```json { "asOf": "2026-05-01", "category": "age_21_plus" } ``` Example response: ```json { "retrievedAt": "2026-11-14T20:00:00.000Z", "asOf": "2026-05-01", "category": "age_21_plus", "supported": true, "hourlyRateGbp": 12.71, "band": "21 and over (National Living Wage)", "effectiveFrom": "2026-04-01", "effectiveTo": "2027-03-31", "sources": [ { "source": "GOV.UK National Minimum Wage rates", "url": "https://www.gov.uk/national-minimum-wage-rates", "retrievedAt": "2026-11-14T20:00:00.000Z", "status": "ok" } ], "limitations": [ "Rates are from the published GOV.UK table for the matching effective period." ] } ``` ### POST /api/v1/labour-tax/us-minimum-wage-lookup $0.02 USDC. Return the federal FLSA minimum wage for a date. State and local rates are not included in this slice. Inputs: asOf, jurisdiction? Docs: https://www.brainiac.software/api/labour-tax/docs#labour-tax-us-minimum-wage-lookup Example request: ```json { "asOf": "2026-05-01", "jurisdiction": "federal" } ``` Example response: ```json { "retrievedAt": "2026-11-14T20:00:00.000Z", "asOf": "2026-05-01", "jurisdiction": "federal", "supported": true, "hourlyRateUsd": 7.25, "effectiveFrom": "2009-07-24", "sources": [ { "source": "US DOL WHD federal minimum wage", "url": "https://www.dol.gov/agencies/whd/minimum-wage", "retrievedAt": "2026-11-14T20:00:00.000Z", "status": "ok" } ], "limitations": [ "Federal FLSA minimum wage only." ] } ``` ### POST /api/v1/labour-tax/uk-holiday-entitlement-calculate $0.02 USDC. Estimate statutory holiday entitlement days from weeks worked in the leave year and days worked per week, using the GOV.UK 5.6-week baseline. Inputs: weeksWorkedInLeaveYear, daysWorkedPerWeek, statutoryWeeks? Docs: https://www.brainiac.software/api/labour-tax/docs#labour-tax-uk-holiday-entitlement-calculate Example request: ```json { "weeksWorkedInLeaveYear": 26, "daysWorkedPerWeek": 5, "statutoryWeeks": 5.6 } ``` Example response: ```json { "retrievedAt": "2026-11-14T20:00:00.000Z", "weeksWorkedInLeaveYear": 26, "daysWorkedPerWeek": 5, "statutoryWeeks": 5.6, "statutoryDaysForFullYear": 28, "leaveYearFraction": 0.5, "entitlementDays": 14, "sources": [ { "source": "GOV.UK calculate holiday entitlement (statutory 5.6 weeks)", "url": "https://www.gov.uk/calculate-your-holiday-entitlement", "retrievedAt": "2026-11-14T20:00:00.000Z", "status": "ok" } ], "limitations": [ "Uses the statutory 5.6-week full-year baseline unless overridden." ] } ``` ### POST /api/v1/labour-tax/iana-timezone-convert $0.01 USDC. Convert an instant between IANA time zones using the runtime Intl/tzdb revision. Coordinate-to-zone lookup is not included. Inputs: instant, fromTimeZone, toTimeZone Docs: https://www.brainiac.software/api/labour-tax/docs#labour-tax-iana-timezone-convert Example request: ```json { "instant": "2026-11-14T18:00:00.000Z", "fromTimeZone": "UTC", "toTimeZone": "America/New_York" } ``` Example response: ```json { "retrievedAt": "2026-11-14T20:00:00.000Z", "instantUtc": "2026-11-14T18:00:00.000Z", "from": { "timeZone": "UTC", "local": "2026-11-14T18:00:00", "offset": "GMT", "supported": true }, "to": { "timeZone": "America/New_York", "local": "2026-11-14T13:00:00", "offset": "GMT-5", "supported": true }, "sources": [ { "source": "IANA Time Zone Database via ECMAScript Intl", "url": "https://www.iana.org/time-zones", "retrievedAt": "2026-11-14T20:00:00.000Z", "status": "ok" } ], "limitations": [ "Requires IANA zone names." ] } ``` ### POST /api/v1/labour-tax/business-day-calendar $0.02 USDC. Report whether a date is a business day on the England & Wales, Scotland, Northern Ireland or US federal holiday calendar, with the holiday name and previous/next business days. Inputs: date, calendar? Docs: https://www.brainiac.software/api/labour-tax/docs#labour-tax-business-day-calendar Example request: ```json { "date": "2026-12-25", "calendar": "england-wales" } ``` Example response: ```json { "retrievedAt": "2026-11-14", "date": "2026-12-25", "calendar": "england-wales", "weekday": 5, "isBusinessDay": false, "isWeekend": false, "isHoliday": true, "holiday": { "date": "2026-12-25", "name": "Christmas Day" }, "previousBusinessDay": "2026-12-24", "nextBusinessDay": "2026-12-29", "coverage": { "from": "2019-01-01", "to": "2028-12-31" }, "sources": [ { "source": "GOV.UK bank holidays (vendored snapshot, Open Government Licence v3.0)", "url": "https://www.gov.uk/bank-holidays.json", "retrievedAt": "2026-11-14", "status": "ok" } ], "limitations": [ "UK bank holidays come from the vendored GOV.UK snapshot (2019-01-01 to 2028-12-31); dates outside that range are reject…", "Weekends are Saturday and Sunday. The england-wales calendar id is kept as an alias of gb-eaw." ] } ``` ### POST /api/v1/labour-tax/uk-statutory-pay-calculate $0.03 USDC. Calculate Statutory Sick Pay and statutory maternity, adoption, paternity, shared parental, parental bereavement and neonatal care pay for tax year 2026-27 from caller-supplied average weekly earnings. Inputs: type, averageWeeklyEarnings, startDate, weeks?, ssp?, smpEligibility? Docs: https://www.brainiac.software/api/labour-tax/docs#labour-tax-uk-statutory-pay-calculate Example request: ```json { "type": "SMP", "averageWeeklyEarnings": 600, "startDate": "2026-06-01", "smpEligibility": { "continuousEmployment26Weeks": true, "noticeGiven": true } } ``` Example response: ```json { "type": "SMP", "weeklyRate": 540, "schedule": [ { "fromWeek": 1, "toWeek": 6, "weeklyAmount": 540 }, { "fromWeek": 7, "toWeek": 39, "weeklyAmount": 194.32 } ], "total": 9652.56, "eligible": true, "reasons": [], "taxYear": "2026-27", "sources": [ { "source": "HMRC rates and thresholds for employers 2026 to 2027", "url": "https://www.gov.uk/guidance/rates-and-thresholds-for-employers-2026-to-2027", "retrievedAt": "2026-09-01", "status": "ok" }, { "source": "GOV.UK Statutory Sick Pay", "url": "https://www.gov.uk/statutory-sick-pay", "retrievedAt": "2026-09-01", "status": "ok" }, "…" ], "limitations": [ "Linked periods of sickness, maximum-weeks rules for SAP/SPP/ShPP, and SSP eligibility facts are caller input and are no…", "Calculated from caller-supplied average weekly earnings for tax year 2026-27. This is not payroll or employment advice." ] } ``` ### POST /api/v1/labour-tax/uk-paye-ni-estimate $0.03 USDC. Estimate income tax and Class 1 employee and employer National Insurance for one pay period at constant pay in tax year 2026-27 (rUK, Scotland and Wales bands). Not a payslip. Inputs: grossPay, period, taxCode?, niCategory? Docs: https://www.brainiac.software/api/labour-tax/docs#labour-tax-uk-paye-ni-estimate Example request: ```json { "grossPay": 3000, "period": "monthly", "taxCode": "1257L", "niCategory": "A" } ``` Example response: ```json { "taxYear": "2026-27", "region": "rUK", "allowanceAnnual": 12570, "incomeTaxPeriod": 390.5, "employeeNiPeriod": 156.16, "employerNiPeriod": 387.45, "bands": [ { "band": "basic", "rate": 0.2, "taxable": 23430, "tax": 4686 }, { "band": "higher", "rate": 0.4, "taxable": 0, "tax": 0 }, "…" ], "assumptions": [ "constant pay all year (annualised, not HMRC cumulative tables)", "Directors' annual earnings period, salary sacrifice, student loans and pension are not applied", "…" ], "sources": [ { "source": "HMRC rates and thresholds for employers 2026 to 2027", "url": "https://www.gov.uk/guidance/rates-and-thresholds-for-employers-2026-to-2027", "retrievedAt": "2026-09-01", "status": "ok" }, { "source": "GOV.UK Income Tax rates and Personal Allowances", "url": "https://www.gov.uk/income-tax-rates", "retrievedAt": "2026-09-01", "status": "ok" } ], "limitations": [ "Estimate for one pay period at constant pay. Not a payslip, P60 or RTI submission.", "K codes and unknown tax codes are rejected. Not tax advice." ] } ``` ### POST /api/v1/labour-tax/us-federal-withholding-estimate $0.03 USDC. Compute federal income-tax withholding for one pay period using IRS Publication 15-T (2026) Worksheet 1A and the Annual Percentage Method tables. FICA is not included. Inputs: taxYear, wagesThisPeriod, payFrequency, w4, nonresidentAlien? Docs: https://www.brainiac.software/api/labour-tax/docs#labour-tax-us-federal-withholding-estimate Example request: ```json { "taxYear": 2026, "wagesThisPeriod": 3000, "payFrequency": "biweekly", "w4": { "formYear": "2020-or-later", "filingStatus": "single_or_mfs", "step2Checkbox": false } } ``` Example response: ```json { "taxYear": 2026, "periodsPerYear": 26, "adjustedAnnualWage": 69400, "tableRow": { "atLeast": 57900, "lessThan": 113200, "base": 5800, "rate": 0.22 }, "tentativeAnnual": 8330, "withholdingThisPeriod": 320.38, "worksheetLines": { "annualWages": 78000, "otherIncome": 0, "deductions": 0, "standardDeduction": 8600, "adjustedAnnualWage": 69400, "tentativeAnnual": 8330, "tentativePerPeriod": 320.38, "creditsPerPeriod": 0, "extraPerPeriod": 0 }, "sources": [ { "source": "IRS Publication 15-T (2026), Worksheet 1A and Annual Percentage Method tables", "url": "https://www.irs.gov/pub/irs-pdf/p15t.pdf", "retrievedAt": "2025-12-11", "status": "ok" } ], "limitations": [ "Federal income-tax withholding only; FICA is not included and the result is not rounded to whole dollars.", "Nonresident-alien adjustment is not implemented. Not tax advice." ] } ``` ### POST /api/v1/labour-tax/uk-sponsor-register-search $0.03 USDC. Check whether an organisation appears on the vendored Home Office Register of licensed sponsors (Worker and Temporary Worker). Returns candidate matches for human review. Inputs: organisationName, town?, route?, limit? Docs: https://www.brainiac.software/api/labour-tax/docs#labour-tax-uk-sponsor-register-search Example request: ```json { "organisationName": "Monzo Bank" } ``` Example response: ```json { "status": "LISTED", "matches": [ { "organisationName": "Monzo Bank Ltd", "town": "London", "county": null, "ratings": [ "Worker (A rating)" ], "routes": [ "Skilled Worker", "Global Business Mobility: Senior or Specialist Worker" ], "score": 1 } ], "registerDate": "2026-11-12", "registerRows": 142998, "sources": [ { "source": "Home Office Register of licensed sponsors: workers (vendored CSV, Open Government Licence v3.0)", "url": "https://www.gov.uk/government/publications/register-of-licensed-sponsors-workers", "retrievedAt": "2026-11-12", "status": "ok" } ], "limitations": [ "The register lists current licence holders only; NOT_FOUND does not prove a licence was never held.", "Name matching is token-based after removing company suffixes and punctuation. Review matches before relying on them.", "…" ] } ```