{"openapi":"3.1.0","info":{"title":"Pay, Tax & Employment Calendars API","version":"1.0.0","description":"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. Paid with x402 exact USDC on Base. No account is required.","contact":{"email":"support@brainiac.software"},"x-guidance":"BRAINIAC.software is a pay-per-call API for software agents. No account or API key is required.\nPayment uses x402 with exact USDC on Base (8453). Each paid resource accepts POST for the call; unpaid GET/HEAD return the same 402 payment challenge for discovery.\nHow to call an operation:\n1. POST JSON matching the requestBody. An unpaid POST (including empty body) returns 402 payment terms before body validation.\n2. Compare 402 payTo, asset, and network with /api/v1/catalog and /.well-known/x402 — not only with the 402 itself.\n3. Pay and retry with payment-signature. Invalid JSON/schema after payment-signature returns 400 and is not charged. Settlement (a charge) only on 2xx. payment-signature attached ≠ charged.\nIdempotency-Key: 64 hex chars from 32 random bytes. Reuse only for the same operation and body (replays stored response, including status=partial). A new key runs a fresh call.\nIdempotency after errors: unpaid 402 does not store the key. Post-signature 402/503 release it (retry same key). Pre-reserve schema 400 does not store it. Other post-signature responses (2xx/4xx/5xx) are stored: same key+body replays; different body → 409. Stored 4xx/5xx replays are not a second charge. Prefer a new key after fixing a 4xx; after 5xx reuse the same key only for the stored error.\nPost-signature 402/503 include prior-payment-attempt (nonce, settled false|unknown). A facilitator 502 is SETTLEMENT_UNKNOWN (stored under the Idempotency-Key; cross-instance replay needs the shared store; may already be charged) — check USDC authorizationState(payer, nonce) on Base before re-signing.\nSettlement signal: settled 2xx include payment-response. 4xx/5xx do not. Do not book a cost from payment-signature alone.\nCoverage billing: HTTP 200 with status complete, partial, or failed is charged at the full listed price. Retrying missing checks needs a new settled call. 4xx/5xx are not charged.\nmissing_items.reason: timeout/rate_limited → one delayed retry (new key); upstream_down → after recovery; not_supported → never.\nInvariants: any missing_items ⇒ not status complete; sources[] is provenance only (source, url, retrievedAt), never success/error keyed by check.\nFree lookup: GET /api/v1/results/{result_id} returns stored coverage JSON (404 RESULT_NOT_FOUND if unknown/expired; not a 402). Prior-Result-Id sets replaces_result_id.\nOutputs are prechecks/drafts for human review — not official determinations, legal advice, or certified filings."},"servers":[{"url":"https://www.brainiac.software"}],"paths":{"/api/v1/labour-tax/uk-minimum-wage-lookup":{"post":{"operationId":"look_up_uk_national_minimum_wage","summary":"Look up UK National Minimum Wage","description":"Return the official GOV.UK National Minimum / Living Wage hourly rate for a date and age/apprentice category from vendored rate rows.","tags":["labour-tax"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"asOf":{"type":"string","minLength":8,"maxLength":32},"category":{"type":"string","enum":["age_21_plus","age_18_to_20","under_18","apprentice"]}},"required":["asOf","category"],"additionalProperties":false},"example":{"asOf":"2026-05-01","category":"age_21_plus"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"retrievedAt":{"type":"string"},"asOf":{"type":"string"},"category":{"type":"string"},"supported":{"type":"boolean"},"hourlyRateGbp":{"type":"number"},"band":{"type":"string"},"effectiveFrom":{"type":"string"},"effectiveTo":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"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."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/labour-tax/us-minimum-wage-lookup":{"post":{"operationId":"look_up_us_federal_minimum_wage","summary":"Look up US federal minimum wage","description":"Return the federal FLSA minimum wage for a date. State and local rates are not included in this slice.","tags":["labour-tax"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"asOf":{"type":"string","minLength":8,"maxLength":32},"jurisdiction":{"default":"federal","type":"string","enum":["federal"]}},"required":["asOf"],"additionalProperties":false},"example":{"asOf":"2026-05-01","jurisdiction":"federal"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"retrievedAt":{"type":"string"},"asOf":{"type":"string"},"jurisdiction":{"type":"string"},"supported":{"type":"boolean"},"hourlyRateUsd":{"type":"number"},"effectiveFrom":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"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."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/labour-tax/uk-holiday-entitlement-calculate":{"post":{"operationId":"calculate_uk_statutory_holiday_entitlement","summary":"Calculate UK statutory holiday entitlement","description":"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.","tags":["labour-tax"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"weeksWorkedInLeaveYear":{"type":"number","minimum":0,"maximum":53},"daysWorkedPerWeek":{"type":"number","minimum":0,"maximum":7},"statutoryWeeks":{"default":5.6,"type":"number","minimum":0,"maximum":8}},"required":["weeksWorkedInLeaveYear","daysWorkedPerWeek"],"additionalProperties":false},"example":{"weeksWorkedInLeaveYear":26,"daysWorkedPerWeek":5,"statutoryWeeks":5.6}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"retrievedAt":{"type":"string"},"weeksWorkedInLeaveYear":{"type":"number"},"daysWorkedPerWeek":{"type":"number"},"statutoryWeeks":{"type":"number"},"statutoryDaysForFullYear":{"type":"number"},"leaveYearFraction":{"type":"number"},"entitlementDays":{"type":"number"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"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."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/labour-tax/iana-timezone-convert":{"post":{"operationId":"convert_a_timestamp_between_iana_time_zones","summary":"Convert a timestamp between IANA time zones","description":"Convert an instant between IANA time zones using the runtime Intl/tzdb revision. Coordinate-to-zone lookup is not included.","tags":["labour-tax"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"instant":{"type":"string","minLength":8,"maxLength":64},"fromTimeZone":{"type":"string","minLength":1,"maxLength":64},"toTimeZone":{"type":"string","minLength":1,"maxLength":64}},"required":["instant","fromTimeZone","toTimeZone"],"additionalProperties":false},"example":{"instant":"2026-11-14T18:00:00.000Z","fromTimeZone":"UTC","toTimeZone":"America/New_York"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"retrievedAt":{"type":"string"},"instantUtc":{"type":"string"},"from":{"type":"object","properties":{"timeZone":{"type":"string"},"local":{"type":"string"},"offset":{"type":"string"},"supported":{"type":"boolean"}},"additionalProperties":true},"to":{"type":"object","properties":{"timeZone":{"type":"string"},"local":{"type":"string"},"offset":{"type":"string"},"supported":{"type":"boolean"}},"additionalProperties":true},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"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."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/labour-tax/business-day-calendar":{"post":{"operationId":"business_day_calendar_uk_us","summary":"Business day calendar (UK/US)","description":"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.","tags":["labour-tax"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"date":{"type":"string","minLength":8,"maxLength":32},"calendar":{"default":"england-wales","type":"string","enum":["england-wales","gb-eaw","gb-sct","gb-nir","us-federal"]}},"required":["date"],"additionalProperties":false},"example":{"date":"2026-12-25","calendar":"england-wales"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"retrievedAt":{"type":"string"},"date":{"type":"string"},"calendar":{"type":"string"},"weekday":{"type":"number"},"isBusinessDay":{"type":"boolean"},"isWeekend":{"type":"boolean"},"isHoliday":{"type":"boolean"},"holiday":{"type":"object","properties":{"date":{"type":"string"},"name":{"type":"string"}},"additionalProperties":true},"previousBusinessDay":{"type":"string"},"nextBusinessDay":{"type":"string"},"coverage":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}},"additionalProperties":true},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"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."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/labour-tax/uk-statutory-pay-calculate":{"post":{"operationId":"calculate_uk_statutory_pay_ssp_smp_sap_spp_shpp_spbp_sncp","summary":"Calculate UK statutory pay (SSP, SMP, SAP, SPP, ShPP, SPBP, SNCP)","description":"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.","tags":["labour-tax"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"type":{"type":"string","enum":["SSP","SMP","SAP","SPP","ShPP","SPBP","SNCP"]},"averageWeeklyEarnings":{"type":"number","minimum":0,"maximum":1000000},"startDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"weeks":{"type":"number","exclusiveMinimum":0,"maximum":52},"ssp":{"type":"object","properties":{"qualifyingDaysPerWeek":{"type":"integer","minimum":1,"maximum":7},"daysToPay":{"type":"integer","minimum":1,"maximum":10000}},"required":["qualifyingDaysPerWeek","daysToPay"],"additionalProperties":false},"smpEligibility":{"type":"object","properties":{"continuousEmployment26Weeks":{"type":"boolean"},"noticeGiven":{"type":"boolean"}},"required":["continuousEmployment26Weeks","noticeGiven"],"additionalProperties":false}},"required":["type","averageWeeklyEarnings","startDate"],"additionalProperties":false},"example":{"type":"SMP","averageWeeklyEarnings":600,"startDate":"2026-06-01","smpEligibility":{"continuousEmployment26Weeks":true,"noticeGiven":true}}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"weeklyRate":{"type":"number"},"schedule":{"type":"array","items":{"type":"object","properties":{"fromWeek":{"type":"number"},"toWeek":{"type":"number"},"weeklyAmount":{"type":"number"}},"additionalProperties":true}},"total":{"type":"number"},"eligible":{"type":"boolean"},"reasons":{"type":"array","items":{}},"taxYear":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"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."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/labour-tax/uk-paye-ni-estimate":{"post":{"operationId":"estimate_uk_paye_income_tax_and_national_insurance","summary":"Estimate UK PAYE income tax and National Insurance","description":"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.","tags":["labour-tax"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"grossPay":{"type":"number","minimum":0,"maximum":100000000},"period":{"type":"string","enum":["weekly","monthly","annual"]},"taxCode":{"type":"string","minLength":2,"maxLength":16},"niCategory":{"default":"A","type":"string","enum":["A","B","C","D","E","F","H","I","J","K","L","M","N","S","V","Z"]}},"required":["grossPay","period"],"additionalProperties":false},"example":{"grossPay":3000,"period":"monthly","taxCode":"1257L","niCategory":"A"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"taxYear":{"type":"string"},"region":{"type":"string"},"allowanceAnnual":{"type":"number"},"incomeTaxPeriod":{"type":"number"},"employeeNiPeriod":{"type":"number"},"employerNiPeriod":{"type":"number"},"bands":{"type":"array","items":{"type":"object","properties":{"band":{"type":"string"},"rate":{"type":"number"},"taxable":{"type":"number"},"tax":{"type":"number"}},"additionalProperties":true}},"assumptions":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"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."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/labour-tax/us-federal-withholding-estimate":{"post":{"operationId":"estimate_us_federal_income_tax_withholding_pub_15_t_2026","summary":"Estimate US federal income-tax withholding (Pub 15-T 2026)","description":"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.","tags":["labour-tax"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"taxYear":{"type":"number","const":2026},"wagesThisPeriod":{"type":"number","minimum":0,"maximum":100000000},"payFrequency":{"type":"string","enum":["daily","weekly","biweekly","semimonthly","monthly","quarterly","semiannually"]},"w4":{"anyOf":[{"type":"object","properties":{"formYear":{"type":"string","const":"2020-or-later"},"filingStatus":{"type":"string","enum":["single_or_mfs","mfj","hoh"]},"step2Checkbox":{"type":"boolean"},"step3Credits":{"type":"number","minimum":0,"maximum":100000000},"step4aOtherIncome":{"type":"number","minimum":0,"maximum":100000000},"step4bDeductions":{"type":"number","minimum":0,"maximum":100000000},"step4cExtra":{"type":"number","minimum":0,"maximum":100000000}},"required":["formYear","filingStatus","step2Checkbox"],"additionalProperties":false},{"type":"object","properties":{"formYear":{"type":"string","const":"2019-or-earlier"},"maritalStatus":{"type":"string","enum":["single","married"]},"allowances":{"type":"integer","minimum":0,"maximum":1000},"additional":{"type":"number","minimum":0,"maximum":100000000}},"required":["formYear","maritalStatus","allowances"],"additionalProperties":false}]},"nonresidentAlien":{"type":"boolean"}},"required":["taxYear","wagesThisPeriod","payFrequency","w4"],"additionalProperties":false},"example":{"taxYear":2026,"wagesThisPeriod":3000,"payFrequency":"biweekly","w4":{"formYear":"2020-or-later","filingStatus":"single_or_mfs","step2Checkbox":false}}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"taxYear":{"type":"number"},"periodsPerYear":{"type":"number"},"adjustedAnnualWage":{"type":"number"},"tableRow":{"type":"object","properties":{"atLeast":{"type":"number"},"lessThan":{"type":"number"},"base":{"type":"number"},"rate":{"type":"number"}},"additionalProperties":true},"tentativeAnnual":{"type":"number"},"withholdingThisPeriod":{"type":"number"},"worksheetLines":{"type":"object","properties":{"annualWages":{"type":"number"},"otherIncome":{"type":"number"},"deductions":{"type":"number"},"standardDeduction":{"type":"number"},"adjustedAnnualWage":{"type":"number"},"tentativeAnnual":{"type":"number"},"tentativePerPeriod":{"type":"number"},"creditsPerPeriod":{"type":"number"},"extraPerPeriod":{"type":"number"}},"additionalProperties":true},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"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."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/labour-tax/uk-sponsor-register-search":{"post":{"operationId":"search_the_uk_licensed_sponsor_register","summary":"Search the UK licensed sponsor register","description":"Check whether an organisation appears on the vendored Home Office Register of licensed sponsors (Worker and Temporary Worker). Returns candidate matches for human review.","tags":["labour-tax"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"organisationName":{"type":"string","minLength":2,"maxLength":200},"town":{"type":"string","minLength":1,"maxLength":100},"route":{"type":"string","minLength":1,"maxLength":100},"limit":{"default":10,"type":"integer","minimum":1,"maximum":50}},"required":["organisationName"],"additionalProperties":false},"example":{"organisationName":"Monzo Bank"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"},"matches":{"type":"array","items":{"type":"object","properties":{"organisationName":{"type":"string"},"town":{"type":"string"},"county":{"type":"null"},"ratings":{"type":"array","items":{"type":"string"}},"routes":{"type":"array","items":{"type":"string"}},"score":{"type":"number"}},"additionalProperties":true}},"registerDate":{"type":"string"},"registerRows":{"type":"number"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"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.","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}}},"components":{"schemas":{"ApiError":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}