{"openapi":"3.1.0","info":{"title":"Global Employment Rules API","version":"1.0.0","description":"Calculate UK statutory notice, redundancy pay, working-time prechecks, US federal/California overtime, and UK gender pay gap figures from caller-supplied facts and published rules. 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/global-employment/uk-statutory-notice-period":{"post":{"operationId":"calculate_uk_statutory_notice_period","summary":"Calculate UK statutory notice period","description":"Calculate the minimum statutory employer notice period in Great Britain from continuous employment dates, and compare it with caller-supplied contractual notice.","tags":["global-employment"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"startDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"noticeDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"contractualNoticeWeeks":{"default":0,"type":"number","minimum":0,"maximum":260}},"required":["startDate","noticeDate"],"additionalProperties":false},"example":{"startDate":"2019-03-01","noticeDate":"2026-11-14","contractualNoticeWeeks":4}}}},"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":{"completedYears":{"type":"number"},"statutoryWeeks":{"type":"number"},"applicableWeeks":{"type":"number"},"reason":{"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":{"completedYears":7,"statutoryWeeks":7,"applicableWeeks":7,"reason":"statutory_exceeds_contract","sources":[{"source":"GOV.UK Redundancy: your rights - notice periods","url":"https://www.gov.uk/redundancy-your-rights/notice-periods","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are statutory calculations and prechecks for human review, not legal, tax, payroll, or HR advice.","Only the cited published rules are encoded; contractual, collective-agreement, sector-specific, and local exceptions ar…"]}}}},"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/global-employment/uk-statutory-redundancy-pay":{"post":{"operationId":"calculate_uk_statutory_redundancy_pay","summary":"Calculate UK statutory redundancy pay","description":"Calculate Great Britain statutory redundancy pay from age, service, redundancy date, and weekly pay using the 2026 cap and 20-year service limit.","tags":["global-employment"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"dateOfBirth":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"startDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"redundancyDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"weeklyPayPence":{"type":"integer","minimum":0,"maximum":100000000}},"required":["dateOfBirth","startDate","redundancyDate","weeklyPayPence"],"additionalProperties":false},"example":{"dateOfBirth":"1966-05-01","startDate":"2001-01-15","redundancyDate":"2026-11-14","weeklyPayPence":80000}}}},"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":{"eligible":{"type":"boolean"},"countedYears":{"type":"number"},"weeksEntitlement":{"type":"number"},"cappedWeeklyPayPence":{"type":"number"},"amountPence":{"type":"number"},"breakdown":{"type":"array","items":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"},"ageInYear":{"type":"number"},"multiplier":{"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":{"eligible":true,"countedYears":20,"weeksEntitlement":29.5,"cappedWeeklyPayPence":75100,"amountPence":2215450,"breakdown":[{"from":"2006-11-14","to":"2007-11-14","ageInYear":40,"multiplier":1},{"from":"2007-11-14","to":"2008-11-14","ageInYear":41,"multiplier":1.5}],"sources":[{"source":"GOV.UK Redundancy: your rights - statutory redundancy pay","url":"https://www.gov.uk/redundancy-your-rights/redundancy-pay","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are statutory calculations and prechecks for human review, not legal, tax, payroll, or HR advice.","Only the cited published rules are encoded; contractual, collective-agreement, sector-specific, and local exceptions ar…"]}}}},"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.04"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/global-employment/uk-working-time-check":{"post":{"operationId":"check_uk_working_time_limits","summary":"Check UK working-time limits","description":"Check caller-supplied shifts against UK 48-hour average, under-18 limits, 20-minute breaks, daily rest, and weekly or fortnightly rest rules.","tags":["global-employment"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shifts":{"minItems":1,"maxItems":2000,"type":"array","items":{"type":"object","properties":{"start":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2})?$"},"end":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2})?$"},"breakMinutes":{"default":0,"type":"number","minimum":0,"maximum":1440}},"required":["start","end"],"additionalProperties":false}},"referenceWeeks":{"default":17,"type":"integer","minimum":1,"maximum":52},"optedOut":{"default":false,"type":"boolean"},"under18":{"default":false,"type":"boolean"}},"required":["shifts"],"additionalProperties":false},"example":{"shifts":[{"start":"2026-11-02T08:00","end":"2026-11-02T17:00","breakMinutes":30}],"referenceWeeks":17,"optedOut":false,"under18":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":{"averageWeeklyHours":{"type":"number"},"violations":{"type":"array","items":{}},"ok":{"type":"boolean"},"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":{"averageWeeklyHours":0.5,"violations":[],"ok":true,"sources":[{"source":"GOV.UK Maximum weekly working hours","url":"https://www.gov.uk/maximum-weekly-working-hours","retrievedAt":"2026-11-14","status":"ok"},{"source":"GOV.UK Rest breaks at work","url":"https://www.gov.uk/rest-breaks-work","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are statutory calculations and prechecks for human review, not legal, tax, payroll, or HR advice.","Only the cited published rules are encoded; contractual, collective-agreement, sector-specific, and local exceptions ar…"]}}}},"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.04"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/global-employment/us-overtime-calculate":{"post":{"operationId":"calculate_us_overtime_pay","summary":"Calculate US overtime pay","description":"Calculate federal FLSA weekly overtime, or California daily, seventh-day, and weekly overtime, from one caller-supplied workweek.","tags":["global-employment"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"jurisdiction":{"type":"string","enum":["federal","california"]},"hourlyRateCents":{"type":"integer","minimum":0,"maximum":1000000},"days":{"minItems":1,"maxItems":7,"type":"array","items":{"type":"object","properties":{"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"hours":{"type":"number","minimum":0,"maximum":24}},"required":["date","hours"],"additionalProperties":false}}},"required":["jurisdiction","hourlyRateCents","days"],"additionalProperties":false},"example":{"jurisdiction":"california","hourlyRateCents":2000,"days":[{"date":"2026-11-02","hours":9},{"date":"2026-11-03","hours":9},{"date":"2026-11-04","hours":9},{"date":"2026-11-05","hours":9},{"date":"2026-11-06","hours":9},{"date":"2026-11-07","hours":9},{"date":"2026-11-08","hours":9}]}}}},"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":{"regularHours":{"type":"number"},"overtime15Hours":{"type":"number"},"doubleTimeHours":{"type":"number"},"regularPayCents":{"type":"number"},"overtimePayCents":{"type":"number"},"doubleTimePayCents":{"type":"number"},"totalCents":{"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":{"regularHours":40,"overtime15Hours":22,"doubleTimeHours":1,"regularPayCents":80000,"overtimePayCents":66000,"doubleTimePayCents":4000,"totalCents":150000,"sources":[{"source":"29 U.S.C. 207(a) and 29 CFR 778.107, FLSA overtime","url":"https://www.ecfr.gov/current/title-29/subtitle-B/chapter-V/subchapter-B/part-778/subpart-B/section-778.107","retrievedAt":"2026-11-14","status":"ok"},{"source":"California DLSE overtime FAQ","url":"https://www.dir.ca.gov/dlse/faq_overtime.htm","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are statutory calculations and prechecks for human review, not legal, tax, payroll, or HR advice.","Only the cited published rules are encoded; contractual, collective-agreement, sector-specific, and local exceptions ar…"]}}}},"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.04"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/global-employment/gender-pay-gap-calc":{"post":{"operationId":"calculate_uk_gender_pay_gap_figures","summary":"Calculate UK gender pay gap figures","description":"Compute UK gender pay gap mean, median, bonus, bonus proportion, quartile, headcount, and reporting-threshold figures from caller-supplied employee-level data.","tags":["global-employment"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"snapshotDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"employees":{"minItems":1,"maxItems":20000,"type":"array","items":{"type":"object","properties":{"sex":{"type":"string","enum":["male","female"]},"fullPayRelevant":{"type":"boolean"},"hourlyPayPence":{"type":"number","minimum":0,"maximum":100000000},"bonusPence":{"default":0,"type":"number","minimum":0,"maximum":1000000000}},"required":["sex","fullPayRelevant","hourlyPayPence"],"additionalProperties":false}}},"required":["snapshotDate","employees"],"additionalProperties":false},"example":{"snapshotDate":"2026-04-05","employees":[{"sex":"male","fullPayRelevant":true,"hourlyPayPence":1000,"bonusPence":0},{"sex":"male","fullPayRelevant":true,"hourlyPayPence":2000,"bonusPence":0},{"sex":"female","fullPayRelevant":true,"hourlyPayPence":1000,"bonusPence":0},{"sex":"female","fullPayRelevant":true,"hourlyPayPence":1000,"bonusPence":0}]}}}},"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":{"meanHourlyGapPct":{"type":"number"},"medianHourlyGapPct":{"type":"number"},"meanBonusGapPct":{"type":"null"},"medianBonusGapPct":{"type":"null"},"receivingBonusPct":{"type":"object","properties":{"male":{"type":"number"},"female":{"type":"number"}},"additionalProperties":true},"quartiles":{"type":"array","items":{"type":"object","properties":{"quartile":{"type":"string"},"malePct":{"type":"number"},"femalePct":{"type":"number"}},"additionalProperties":true}},"headcount":{"type":"number"},"reportingRequired":{"type":"boolean"},"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":{"meanHourlyGapPct":33.3,"medianHourlyGapPct":33.3,"meanBonusGapPct":null,"medianBonusGapPct":null,"receivingBonusPct":{"male":0,"female":0},"quartiles":[{"quartile":"lower","malePct":50,"femalePct":50},{"quartile":"lower_middle","malePct":0,"femalePct":100},"…"],"headcount":4,"reportingRequired":false,"sources":[{"source":"GOV.UK Gender pay gap reporting: make your calculations","url":"https://www.gov.uk/guidance/gender-pay-gap-reporting-make-your-calculations","retrievedAt":"2026-11-14","status":"ok"},{"source":"Equality Act 2010 (Gender Pay Gap Information) Regulations 2017","url":"https://www.legislation.gov.uk/uksi/2017/172/contents/made","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are statutory calculations and prechecks for human review, not legal, tax, payroll, or HR advice.","Only the cited published rules are encoded; contractual, collective-agreement, sector-specific, and local exceptions ar…"]}}}},"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.04"},"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":{}}}}}}}}