https://www.brainiac.software/api/v1/labour-tax/uk-minimum-wage-lookup$0.01 USDCLook up UK National Minimum Wage
Return the official GOV.UK National Minimum / Living Wage hourly rate for a date and age/apprentice category from vendored rate rows.
Body
| Field | Required | Notes |
|---|---|---|
asOf | Yes | string |
category | Yes | string; One of: age_21_plus, age_18_to_20, under_18, apprentice |
Request exampleJSON
{
"asOf": "2026-05-01",
"category": "age_21_plus"
}Response exampleJSON
{
"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."
]
}cURL
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"
}
JSONhttps://www.brainiac.software/api/v1/labour-tax/us-minimum-wage-lookup$0.02 USDCLook up US federal minimum wage
Return the federal FLSA minimum wage for a date. State and local rates are not included in this slice.
Body
| Field | Required | Notes |
|---|---|---|
asOf | Yes | string |
jurisdiction | No | string; One of: federal; Default: "federal" |
Request exampleJSON
{
"asOf": "2026-05-01",
"jurisdiction": "federal"
}Response exampleJSON
{
"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."
]
}cURL
curl -i -X POST "https://www.brainiac.software/api/v1/labour-tax/us-minimum-wage-lookup" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"asOf": "2026-05-01",
"jurisdiction": "federal"
}
JSONhttps://www.brainiac.software/api/v1/labour-tax/uk-holiday-entitlement-calculate$0.02 USDCCalculate UK statutory holiday entitlement
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.
Body
| Field | Required | Notes |
|---|---|---|
weeksWorkedInLeaveYear | Yes | number |
daysWorkedPerWeek | Yes | number |
statutoryWeeks | No | number; Default: 5.6 |
Request exampleJSON
{
"weeksWorkedInLeaveYear": 26,
"daysWorkedPerWeek": 5,
"statutoryWeeks": 5.6
}Response exampleJSON
{
"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."
]
}cURL
curl -i -X POST "https://www.brainiac.software/api/v1/labour-tax/uk-holiday-entitlement-calculate" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"weeksWorkedInLeaveYear": 26,
"daysWorkedPerWeek": 5,
"statutoryWeeks": 5.6
}
JSONhttps://www.brainiac.software/api/v1/labour-tax/iana-timezone-convert$0.01 USDCConvert a timestamp between IANA time zones
Convert an instant between IANA time zones using the runtime Intl/tzdb revision. Coordinate-to-zone lookup is not included.
Body
| Field | Required | Notes |
|---|---|---|
instant | Yes | string |
fromTimeZone | Yes | string |
toTimeZone | Yes | string |
Request exampleJSON
{
"instant": "2026-11-14T18:00:00.000Z",
"fromTimeZone": "UTC",
"toTimeZone": "America/New_York"
}Response exampleJSON
{
"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."
]
}cURL
curl -i -X POST "https://www.brainiac.software/api/v1/labour-tax/iana-timezone-convert" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"instant": "2026-11-14T18:00:00.000Z",
"fromTimeZone": "UTC",
"toTimeZone": "America/New_York"
}
JSONhttps://www.brainiac.software/api/v1/labour-tax/business-day-calendar$0.02 USDCBusiness day calendar (UK/US)
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.
Body
| Field | Required | Notes |
|---|---|---|
date | Yes | string |
calendar | No | string; One of: england-wales, gb-eaw, gb-sct, gb-nir, us-federal; Default: "england-wales" |
Request exampleJSON
{
"date": "2026-12-25",
"calendar": "england-wales"
}Response exampleJSON
{
"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."
]
}cURL
curl -i -X POST "https://www.brainiac.software/api/v1/labour-tax/business-day-calendar" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"date": "2026-12-25",
"calendar": "england-wales"
}
JSONhttps://www.brainiac.software/api/v1/labour-tax/uk-statutory-pay-calculate$0.03 USDCCalculate UK statutory pay (SSP, SMP, SAP, SPP, ShPP, SPBP, SNCP)
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.
Body
| Field | Required | Notes |
|---|---|---|
type | Yes | string; One of: SSP, SMP, SAP, SPP, ShPP, SPBP, SNCP |
averageWeeklyEarnings | Yes | number |
startDate | Yes | string |
weeks | No | number |
ssp | No | object; Object |
smpEligibility | No | object; Object |
Request exampleJSON
{
"type": "SMP",
"averageWeeklyEarnings": 600,
"startDate": "2026-06-01",
"smpEligibility": {
"continuousEmployment26Weeks": true,
"noticeGiven": true
}
}Response exampleJSON
{
"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."
]
}cURL
curl -i -X POST "https://www.brainiac.software/api/v1/labour-tax/uk-statutory-pay-calculate" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"type": "SMP",
"averageWeeklyEarnings": 600,
"startDate": "2026-06-01",
"smpEligibility": {
"continuousEmployment26Weeks": true,
"noticeGiven": true
}
}
JSONhttps://www.brainiac.software/api/v1/labour-tax/uk-paye-ni-estimate$0.03 USDCEstimate UK PAYE income tax and National Insurance
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.
Body
| Field | Required | Notes |
|---|---|---|
grossPay | Yes | number |
period | Yes | string; One of: weekly, monthly, annual |
taxCode | No | string |
niCategory | No | string; One of: A, B, C, D, E, F, H, I, J, K, L, M, N, S, V, Z; Default: "A" |
Request exampleJSON
{
"grossPay": 3000,
"period": "monthly",
"taxCode": "1257L",
"niCategory": "A"
}Response exampleJSON
{
"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."
]
}cURL
curl -i -X POST "https://www.brainiac.software/api/v1/labour-tax/uk-paye-ni-estimate" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"grossPay": 3000,
"period": "monthly",
"taxCode": "1257L",
"niCategory": "A"
}
JSONhttps://www.brainiac.software/api/v1/labour-tax/us-federal-withholding-estimate$0.03 USDCEstimate US federal income-tax withholding (Pub 15-T 2026)
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.
Body
| Field | Required | Notes |
|---|---|---|
taxYear | Yes | number |
wagesThisPeriod | Yes | number |
payFrequency | Yes | string; One of: daily, weekly, biweekly, semimonthly, monthly, quarterly, semiannually |
w4 | Yes | — |
nonresidentAlien | No | boolean |
Request exampleJSON
{
"taxYear": 2026,
"wagesThisPeriod": 3000,
"payFrequency": "biweekly",
"w4": {
"formYear": "2020-or-later",
"filingStatus": "single_or_mfs",
"step2Checkbox": false
}
}Response exampleJSON
{
"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."
]
}cURL
curl -i -X POST "https://www.brainiac.software/api/v1/labour-tax/us-federal-withholding-estimate" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"taxYear": 2026,
"wagesThisPeriod": 3000,
"payFrequency": "biweekly",
"w4": {
"formYear": "2020-or-later",
"filingStatus": "single_or_mfs",
"step2Checkbox": false
}
}
JSONhttps://www.brainiac.software/api/v1/labour-tax/uk-sponsor-register-search$0.03 USDCSearch the UK licensed sponsor register
Check whether an organisation appears on the vendored Home Office Register of licensed sponsors (Worker and Temporary Worker). Returns candidate matches for human review.
Body
| Field | Required | Notes |
|---|---|---|
organisationName | Yes | string |
town | No | string |
route | No | string |
limit | No | integer; Default: 10 |
Request exampleJSON
{
"organisationName": "Monzo Bank"
}Response exampleJSON
{
"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.",
"…"
]
}cURL
curl -i -X POST "https://www.brainiac.software/api/v1/labour-tax/uk-sponsor-register-search" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"organisationName": "Monzo Bank"
}
JSON