{"openapi":"3.1.0","info":{"title":"HR Operations API","version":"1.0.0","description":"Read supplied employee records and policies, list missing or expired documents, and build onboarding and offboarding checklists from those policies. 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 the x402 protocol with exact USDC on Base (chain id 8453). Each POST operation has a fixed USD price.\nHow to call an operation:\n1. POST a JSON body matching the operation's requestBody schema to the operation path. Include an Idempotency-Key header (64 hex characters, 32 random bytes).\n2. If you have not paid, the server responds 402 with payment requirements in the body. Pay the exact amount to the payTo address on Base.\n3. Retry the identical request with the same Idempotency-Key and add a payment-signature header containing the x402 payment payload. On success (200) the operation result is returned.\n4. Reuse the same Idempotency-Key only for retries of the same operation and request body; it will not be charged twice.\nAll outputs are compliance prechecks, drafts, or data lookups for human review. They are not official determinations, legal advice, identity confirmation, or certified filings. Verify time-sensitive or official data with the cited source before acting."},"servers":[{"url":"https://www.brainiac.software"}],"paths":{"/api/v1/hr-operations/employee-document-extract":{"post":{"operationId":"extract_employee_documents","summary":"Extract employee documents","description":"Read employee records and labeled document lines supplied by the caller. Dates, roles, and document types are returned as supplied. Document numbers are masked.","tags":["hr-operations"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"employees":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"name":{"type":"string","minLength":1,"maxLength":120},"role":{"type":"string","minLength":1,"maxLength":120},"startDate":{"type":"string","minLength":1,"maxLength":20},"endDate":{"type":"string","minLength":1,"maxLength":20},"email":{"type":"string","minLength":1,"maxLength":254}},"additionalProperties":false}},"documents":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"employeeId":{"type":"string","minLength":1,"maxLength":80},"type":{"type":"string","minLength":1,"maxLength":80},"identifier":{"type":"string","minLength":1,"maxLength":80},"issuedOn":{"type":"string","minLength":1,"maxLength":20},"expiresOn":{"type":"string","minLength":1,"maxLength":20}},"additionalProperties":false}},"policies":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"stage":{"type":"string","minLength":1,"maxLength":40},"name":{"type":"string","minLength":1,"maxLength":160},"kind":{"type":"string","minLength":1,"maxLength":40},"match":{"type":"string","minLength":1,"maxLength":80},"effectiveOn":{"type":"string","minLength":1,"maxLength":20}},"additionalProperties":false}},"acknowledgements":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"employeeId":{"type":"string","minLength":1,"maxLength":80},"policyId":{"type":"string","minLength":1,"maxLength":80},"acknowledgedOn":{"type":"string","minLength":1,"maxLength":20}},"additionalProperties":false}},"completions":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"employeeId":{"type":"string","minLength":1,"maxLength":80},"requirementId":{"type":"string","minLength":1,"maxLength":80}},"additionalProperties":false}},"requirements":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":40}},"required":["field"],"additionalProperties":false}},"text":{"type":"string","minLength":1,"maxLength":20000},"csv":{"type":"string","minLength":1,"maxLength":200000},"json":{"type":"string","minLength":1,"maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/csv","application/json","text/plain"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"roleText":{"type":"string","minLength":1,"maxLength":20000},"employeeText":{"type":"string","minLength":1,"maxLength":20000},"asOf":{"type":"string","minLength":1,"maxLength":10},"withinDays":{"type":"integer","minimum":1,"maximum":3650}},"additionalProperties":false},"example":{"employees":[{"id":"E-100","name":"Ada Lovelace","role":"Engineer","startDate":"2024-01-15"}],"documents":[{"employeeId":"E-100","type":"passport","identifier":"AB1234567","issuedOn":"2019-01-01","expiresOn":"2020-06-01"},{"employeeId":"E-100","type":"passport","identifier":"ZZ9999999","issuedOn":"2019-01-01","expiresOn":"2021-06-01"}]}}}},"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. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"legalCompliance":{"type":"boolean"},"employmentDecision":{"type":"boolean"},"accessChanged":{"type":"boolean"},"status":{"type":"string"},"employeeCount":{"type":"number"},"documentCount":{"type":"number"},"employees":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"startDate":{"type":"string"},"endDate":{"type":"string"}},"additionalProperties":true}},"documents":{"type":"array","items":{"type":"object","properties":{"employeeId":{"type":"string"},"type":{"type":"string"},"identifierMasked":{"type":"string"},"issuedOn":{"type":"string"},"expiresOn":{"type":"string"}},"additionalProperties":true}},"issues":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"employeeId":{"type":"string"},"field":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-03T13:00:00.000Z","legalCompliance":false,"employmentDecision":false,"accessChanged":false,"status":"extracted","employeeCount":1,"documentCount":2,"employees":[{"id":"E-100","name":"Ada Lovelace","role":"Engineer","startDate":"2024-01-15","endDate":""}],"documents":[{"employeeId":"E-100","type":"passport","identifierMasked":"••••4567","issuedOn":"2019-01-01","expiresOn":"2020-06-01"},{"employeeId":"E-100","type":"passport","identifierMasked":"••••9999","issuedOn":"2019-01-01","expiresOn":"2021-06-01"}],"issues":[{"kind":"conflict","code":"identifier_differs","employeeId":"E-100","field":"passport","detail":"Two records of this document type list different identifiers. Neither was chosen."},{"kind":"conflict","code":"expiry_differs","employeeId":"E-100","field":"passport","detail":"Two records of this document type list different expiry dates. Neither was chosen."}],"limitations":["No employment decision is made and no access is changed.","Employment law requirements are not invented. Checklist items come only from supplied policies.","This result is not a legal compliance determination.","Document numbers are masked, and email addresses are not copied into the response.","A missing item means it was not in the request."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/hr-operations/employee-record-validate":{"post":{"operationId":"validate_employee_records","summary":"Validate employee records","description":"Compare employee records with the required fields supplied by the caller, and report an end date that falls before the start date. No legal requirement is added.","tags":["hr-operations"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"employees":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"name":{"type":"string","minLength":1,"maxLength":120},"role":{"type":"string","minLength":1,"maxLength":120},"startDate":{"type":"string","minLength":1,"maxLength":20},"endDate":{"type":"string","minLength":1,"maxLength":20},"email":{"type":"string","minLength":1,"maxLength":254}},"additionalProperties":false}},"documents":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"employeeId":{"type":"string","minLength":1,"maxLength":80},"type":{"type":"string","minLength":1,"maxLength":80},"identifier":{"type":"string","minLength":1,"maxLength":80},"issuedOn":{"type":"string","minLength":1,"maxLength":20},"expiresOn":{"type":"string","minLength":1,"maxLength":20}},"additionalProperties":false}},"policies":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"stage":{"type":"string","minLength":1,"maxLength":40},"name":{"type":"string","minLength":1,"maxLength":160},"kind":{"type":"string","minLength":1,"maxLength":40},"match":{"type":"string","minLength":1,"maxLength":80},"effectiveOn":{"type":"string","minLength":1,"maxLength":20}},"additionalProperties":false}},"acknowledgements":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"employeeId":{"type":"string","minLength":1,"maxLength":80},"policyId":{"type":"string","minLength":1,"maxLength":80},"acknowledgedOn":{"type":"string","minLength":1,"maxLength":20}},"additionalProperties":false}},"completions":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"employeeId":{"type":"string","minLength":1,"maxLength":80},"requirementId":{"type":"string","minLength":1,"maxLength":80}},"additionalProperties":false}},"requirements":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":40}},"required":["field"],"additionalProperties":false}},"text":{"type":"string","minLength":1,"maxLength":20000},"csv":{"type":"string","minLength":1,"maxLength":200000},"json":{"type":"string","minLength":1,"maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/csv","application/json","text/plain"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"roleText":{"type":"string","minLength":1,"maxLength":20000},"employeeText":{"type":"string","minLength":1,"maxLength":20000},"asOf":{"type":"string","minLength":1,"maxLength":10},"withinDays":{"type":"integer","minimum":1,"maximum":3650}},"additionalProperties":false},"example":{"employees":[{"id":"E-100","name":"Ada Lovelace","role":"Engineer","startDate":"2024-01-15","endDate":"2023-01-01"}],"requirements":[{"field":"email"},{"field":"role"}]}}}},"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. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"legalCompliance":{"type":"boolean"},"employmentDecision":{"type":"boolean"},"accessChanged":{"type":"boolean"},"status":{"type":"string"},"employeeCount":{"type":"number"},"records":{"type":"array","items":{"type":"object","properties":{"employeeId":{"type":"string"},"status":{"type":"string"},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"conflicts":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}}},"additionalProperties":true}},"issues":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-03T13:00:00.000Z","legalCompliance":false,"employmentDecision":false,"accessChanged":false,"status":"checked","employeeCount":1,"records":[{"employeeId":"E-100","status":"conflict","missing":[{"field":"email","detail":"The required email was not supplied."}],"conflicts":[{"field":"endDate","detail":"The end date is before the start date. The dates were not rewritten."}]}],"issues":[],"limitations":["No employment decision is made and no access is changed.","Employment law requirements are not invented. Checklist items come only from supplied policies.","This result is not a legal compliance determination.","Document numbers are masked, and email addresses are not copied into the response.","A missing item means it was not in the request."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/hr-operations/employee-policy-acknowledgement-check":{"post":{"operationId":"check_policy_acknowledgements","summary":"Check policy acknowledgements","description":"Match supplied acknowledgements to supplied policies by policy id. An acknowledgement dated before the policy date is stale. This is not a compliance determination.","tags":["hr-operations"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"employees":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"name":{"type":"string","minLength":1,"maxLength":120},"role":{"type":"string","minLength":1,"maxLength":120},"startDate":{"type":"string","minLength":1,"maxLength":20},"endDate":{"type":"string","minLength":1,"maxLength":20},"email":{"type":"string","minLength":1,"maxLength":254}},"additionalProperties":false}},"documents":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"employeeId":{"type":"string","minLength":1,"maxLength":80},"type":{"type":"string","minLength":1,"maxLength":80},"identifier":{"type":"string","minLength":1,"maxLength":80},"issuedOn":{"type":"string","minLength":1,"maxLength":20},"expiresOn":{"type":"string","minLength":1,"maxLength":20}},"additionalProperties":false}},"policies":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"stage":{"type":"string","minLength":1,"maxLength":40},"name":{"type":"string","minLength":1,"maxLength":160},"kind":{"type":"string","minLength":1,"maxLength":40},"match":{"type":"string","minLength":1,"maxLength":80},"effectiveOn":{"type":"string","minLength":1,"maxLength":20}},"additionalProperties":false}},"acknowledgements":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"employeeId":{"type":"string","minLength":1,"maxLength":80},"policyId":{"type":"string","minLength":1,"maxLength":80},"acknowledgedOn":{"type":"string","minLength":1,"maxLength":20}},"additionalProperties":false}},"completions":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"employeeId":{"type":"string","minLength":1,"maxLength":80},"requirementId":{"type":"string","minLength":1,"maxLength":80}},"additionalProperties":false}},"requirements":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":40}},"required":["field"],"additionalProperties":false}},"text":{"type":"string","minLength":1,"maxLength":20000},"csv":{"type":"string","minLength":1,"maxLength":200000},"json":{"type":"string","minLength":1,"maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/csv","application/json","text/plain"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"roleText":{"type":"string","minLength":1,"maxLength":20000},"employeeText":{"type":"string","minLength":1,"maxLength":20000},"asOf":{"type":"string","minLength":1,"maxLength":10},"withinDays":{"type":"integer","minimum":1,"maximum":3650}},"additionalProperties":false},"example":{"employees":[{"id":"E-100","name":"Ada Lovelace"}],"policies":[{"id":"P4","stage":"acknowledgement","name":"Safety handbook","kind":"policy","effectiveOn":"2026-06-01"},{"id":"P5","stage":"acknowledgement","name":"Privacy notice","kind":"policy","effectiveOn":"2026-01-01"}],"acknowledgements":[{"employeeId":"E-100","policyId":"P4","acknowledgedOn":"2026-01-01"}]}}}},"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. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"legalCompliance":{"type":"boolean"},"employmentDecision":{"type":"boolean"},"accessChanged":{"type":"boolean"},"status":{"type":"string"},"checks":{"type":"array","items":{"type":"object","properties":{"employeeId":{"type":"string"},"policyId":{"type":"string"},"policyName":{"type":"string"},"status":{"type":"string"},"acknowledgedOn":{"type":"string"},"effectiveOn":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"issues":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-03T13:00:00.000Z","legalCompliance":false,"employmentDecision":false,"accessChanged":false,"status":"checked","checks":[{"employeeId":"E-100","policyId":"P4","policyName":"Safety handbook","status":"stale","acknowledgedOn":"2026-01-01","effectiveOn":"2026-06-01","detail":"The acknowledgement date is before the supplied policy date. The policy was not treated as current."},{"employeeId":"E-100","policyId":"P5","policyName":"Privacy notice","status":"missing","acknowledgedOn":"","effectiveOn":"2026-01-01","detail":"No acknowledgement was supplied for this policy."}],"issues":[],"limitations":["No employment decision is made and no access is changed.","Employment law requirements are not invented. Checklist items come only from supplied policies.","This result is not a legal compliance determination.","Document numbers are masked, and email addresses are not copied into the response.","A missing item means it was not in the request."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/hr-operations/employee-onboarding-checklist":{"post":{"operationId":"list_onboarding_tasks","summary":"List onboarding tasks","description":"Build an onboarding checklist only from supplied onboarding policies. A document or acknowledgement counts only when it matches that policy. No statutory form is added.","tags":["hr-operations"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"employees":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"name":{"type":"string","minLength":1,"maxLength":120},"role":{"type":"string","minLength":1,"maxLength":120},"startDate":{"type":"string","minLength":1,"maxLength":20},"endDate":{"type":"string","minLength":1,"maxLength":20},"email":{"type":"string","minLength":1,"maxLength":254}},"additionalProperties":false}},"documents":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"employeeId":{"type":"string","minLength":1,"maxLength":80},"type":{"type":"string","minLength":1,"maxLength":80},"identifier":{"type":"string","minLength":1,"maxLength":80},"issuedOn":{"type":"string","minLength":1,"maxLength":20},"expiresOn":{"type":"string","minLength":1,"maxLength":20}},"additionalProperties":false}},"policies":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"stage":{"type":"string","minLength":1,"maxLength":40},"name":{"type":"string","minLength":1,"maxLength":160},"kind":{"type":"string","minLength":1,"maxLength":40},"match":{"type":"string","minLength":1,"maxLength":80},"effectiveOn":{"type":"string","minLength":1,"maxLength":20}},"additionalProperties":false}},"acknowledgements":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"employeeId":{"type":"string","minLength":1,"maxLength":80},"policyId":{"type":"string","minLength":1,"maxLength":80},"acknowledgedOn":{"type":"string","minLength":1,"maxLength":20}},"additionalProperties":false}},"completions":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"employeeId":{"type":"string","minLength":1,"maxLength":80},"requirementId":{"type":"string","minLength":1,"maxLength":80}},"additionalProperties":false}},"requirements":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":40}},"required":["field"],"additionalProperties":false}},"text":{"type":"string","minLength":1,"maxLength":20000},"csv":{"type":"string","minLength":1,"maxLength":200000},"json":{"type":"string","minLength":1,"maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/csv","application/json","text/plain"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"roleText":{"type":"string","minLength":1,"maxLength":20000},"employeeText":{"type":"string","minLength":1,"maxLength":20000},"asOf":{"type":"string","minLength":1,"maxLength":10},"withinDays":{"type":"integer","minimum":1,"maximum":3650}},"additionalProperties":false},"example":{"employees":[{"id":"E-100","name":"Ada Lovelace"}],"documents":[{"employeeId":"E-100","type":"passport","identifier":"AB1234567","expiresOn":"2030-01-01"}],"policies":[{"id":"P1","stage":"onboarding","name":"Identification","kind":"document","match":"passport"},{"id":"P2","stage":"onboarding","name":"Handbook","kind":"policy"}]}}}},"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. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"legalCompliance":{"type":"boolean"},"employmentDecision":{"type":"boolean"},"accessChanged":{"type":"boolean"},"status":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"employeeId":{"type":"string"},"requirementId":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string"},"status":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"issues":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-03T13:00:00.000Z","legalCompliance":false,"employmentDecision":false,"accessChanged":false,"status":"listed","items":[{"employeeId":"E-100","requirementId":"P1","name":"Identification","kind":"document","status":"met","detail":"A supplied document record matches this policy."},{"employeeId":"E-100","requirementId":"P2","name":"Handbook","kind":"policy","status":"missing","detail":"No supplied policy record matches this policy."}],"issues":[],"limitations":["No employment decision is made and no access is changed.","Employment law requirements are not invented. Checklist items come only from supplied policies.","This result is not a legal compliance determination.","Document numbers are masked, and email addresses are not copied into the response.","A missing item means it was not in the request."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/api/v1/hr-operations/employee-offboarding-checklist":{"post":{"operationId":"list_offboarding_tasks","summary":"List offboarding tasks","description":"Build an offboarding checklist only from supplied offboarding policies. A task is met only by a supplied completion record. Access is not changed.","tags":["hr-operations"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"employees":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"name":{"type":"string","minLength":1,"maxLength":120},"role":{"type":"string","minLength":1,"maxLength":120},"startDate":{"type":"string","minLength":1,"maxLength":20},"endDate":{"type":"string","minLength":1,"maxLength":20},"email":{"type":"string","minLength":1,"maxLength":254}},"additionalProperties":false}},"documents":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"employeeId":{"type":"string","minLength":1,"maxLength":80},"type":{"type":"string","minLength":1,"maxLength":80},"identifier":{"type":"string","minLength":1,"maxLength":80},"issuedOn":{"type":"string","minLength":1,"maxLength":20},"expiresOn":{"type":"string","minLength":1,"maxLength":20}},"additionalProperties":false}},"policies":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"stage":{"type":"string","minLength":1,"maxLength":40},"name":{"type":"string","minLength":1,"maxLength":160},"kind":{"type":"string","minLength":1,"maxLength":40},"match":{"type":"string","minLength":1,"maxLength":80},"effectiveOn":{"type":"string","minLength":1,"maxLength":20}},"additionalProperties":false}},"acknowledgements":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"employeeId":{"type":"string","minLength":1,"maxLength":80},"policyId":{"type":"string","minLength":1,"maxLength":80},"acknowledgedOn":{"type":"string","minLength":1,"maxLength":20}},"additionalProperties":false}},"completions":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"employeeId":{"type":"string","minLength":1,"maxLength":80},"requirementId":{"type":"string","minLength":1,"maxLength":80}},"additionalProperties":false}},"requirements":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":40}},"required":["field"],"additionalProperties":false}},"text":{"type":"string","minLength":1,"maxLength":20000},"csv":{"type":"string","minLength":1,"maxLength":200000},"json":{"type":"string","minLength":1,"maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/csv","application/json","text/plain"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"roleText":{"type":"string","minLength":1,"maxLength":20000},"employeeText":{"type":"string","minLength":1,"maxLength":20000},"asOf":{"type":"string","minLength":1,"maxLength":10},"withinDays":{"type":"integer","minimum":1,"maximum":3650}},"additionalProperties":false},"example":{"employees":[{"id":"E-100","name":"Ada Lovelace"}],"policies":[{"id":"P3","stage":"offboarding","name":"Return equipment","kind":"task"}]}}}},"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. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"legalCompliance":{"type":"boolean"},"employmentDecision":{"type":"boolean"},"accessChanged":{"type":"boolean"},"status":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"employeeId":{"type":"string"},"requirementId":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string"},"status":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"issues":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-03T13:00:00.000Z","legalCompliance":false,"employmentDecision":false,"accessChanged":false,"status":"listed","items":[{"employeeId":"E-100","requirementId":"P3","name":"Return equipment","kind":"task","status":"missing","detail":"No supplied task record matches this policy. Access was not changed."}],"issues":[],"limitations":["No employment decision is made and no access is changed.","Employment law requirements are not invented. Checklist items come only from supplied policies.","This result is not a legal compliance determination.","Document numbers are masked, and email addresses are not copied into the response.","A missing item means it was not in the request."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/api/v1/hr-operations/job-role-description-compare":{"post":{"operationId":"compare_a_role_description","summary":"Compare a role description","description":"Compare Duty lines in a role description with Duty lines supplied for an employee. Unlabeled prose is not a duty. The comparison is not an employment decision.","tags":["hr-operations"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"employees":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"name":{"type":"string","minLength":1,"maxLength":120},"role":{"type":"string","minLength":1,"maxLength":120},"startDate":{"type":"string","minLength":1,"maxLength":20},"endDate":{"type":"string","minLength":1,"maxLength":20},"email":{"type":"string","minLength":1,"maxLength":254}},"additionalProperties":false}},"documents":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"employeeId":{"type":"string","minLength":1,"maxLength":80},"type":{"type":"string","minLength":1,"maxLength":80},"identifier":{"type":"string","minLength":1,"maxLength":80},"issuedOn":{"type":"string","minLength":1,"maxLength":20},"expiresOn":{"type":"string","minLength":1,"maxLength":20}},"additionalProperties":false}},"policies":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"stage":{"type":"string","minLength":1,"maxLength":40},"name":{"type":"string","minLength":1,"maxLength":160},"kind":{"type":"string","minLength":1,"maxLength":40},"match":{"type":"string","minLength":1,"maxLength":80},"effectiveOn":{"type":"string","minLength":1,"maxLength":20}},"additionalProperties":false}},"acknowledgements":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"employeeId":{"type":"string","minLength":1,"maxLength":80},"policyId":{"type":"string","minLength":1,"maxLength":80},"acknowledgedOn":{"type":"string","minLength":1,"maxLength":20}},"additionalProperties":false}},"completions":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"employeeId":{"type":"string","minLength":1,"maxLength":80},"requirementId":{"type":"string","minLength":1,"maxLength":80}},"additionalProperties":false}},"requirements":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":40}},"required":["field"],"additionalProperties":false}},"text":{"type":"string","minLength":1,"maxLength":20000},"csv":{"type":"string","minLength":1,"maxLength":200000},"json":{"type":"string","minLength":1,"maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/csv","application/json","text/plain"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"roleText":{"type":"string","minLength":1,"maxLength":20000},"employeeText":{"type":"string","minLength":1,"maxLength":20000},"asOf":{"type":"string","minLength":1,"maxLength":10},"withinDays":{"type":"integer","minimum":1,"maximum":3650}},"additionalProperties":false},"example":{"roleText":"Title: Press operator\nDuty: Operate the press\nDuty: Train new operators\n","employeeText":"Title: Press operator\nDuty: Operate the press\nDuty: Sweep the floor\n"}}}},"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. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"legalCompliance":{"type":"boolean"},"employmentDecision":{"type":"boolean"},"accessChanged":{"type":"boolean"},"status":{"type":"string"},"roleTitle":{"type":"string"},"employeeTitle":{"type":"string"},"matched":{"type":"array","items":{"type":"object","properties":{"duty":{"type":"string"}},"additionalProperties":true}},"missing":{"type":"array","items":{"type":"object","properties":{"duty":{"type":"string"}},"additionalProperties":true}},"extra":{"type":"array","items":{"type":"object","properties":{"duty":{"type":"string"}},"additionalProperties":true}},"issues":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-03T13:00:00.000Z","legalCompliance":false,"employmentDecision":false,"accessChanged":false,"status":"compared","roleTitle":"Press operator","employeeTitle":"Press operator","matched":[{"duty":"Operate the press"}],"missing":[{"duty":"Train new operators"}],"extra":[{"duty":"Sweep the floor"}],"issues":[],"limitations":["No employment decision is made and no access is changed.","Employment law requirements are not invented. Checklist items come only from supplied policies.","This result is not a legal compliance determination.","Document numbers are masked, and email addresses are not copied into the response.","A missing item means it was not in the request."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/hr-operations/workforce-document-expiry-check":{"post":{"operationId":"check_document_expiry","summary":"Check document expiry","description":"Compare supplied expiry dates with a supplied as-of date. A document is due only inside the supplied day window. No date is invented when the as-of date is missing.","tags":["hr-operations"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"employees":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"name":{"type":"string","minLength":1,"maxLength":120},"role":{"type":"string","minLength":1,"maxLength":120},"startDate":{"type":"string","minLength":1,"maxLength":20},"endDate":{"type":"string","minLength":1,"maxLength":20},"email":{"type":"string","minLength":1,"maxLength":254}},"additionalProperties":false}},"documents":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"employeeId":{"type":"string","minLength":1,"maxLength":80},"type":{"type":"string","minLength":1,"maxLength":80},"identifier":{"type":"string","minLength":1,"maxLength":80},"issuedOn":{"type":"string","minLength":1,"maxLength":20},"expiresOn":{"type":"string","minLength":1,"maxLength":20}},"additionalProperties":false}},"policies":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"stage":{"type":"string","minLength":1,"maxLength":40},"name":{"type":"string","minLength":1,"maxLength":160},"kind":{"type":"string","minLength":1,"maxLength":40},"match":{"type":"string","minLength":1,"maxLength":80},"effectiveOn":{"type":"string","minLength":1,"maxLength":20}},"additionalProperties":false}},"acknowledgements":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"employeeId":{"type":"string","minLength":1,"maxLength":80},"policyId":{"type":"string","minLength":1,"maxLength":80},"acknowledgedOn":{"type":"string","minLength":1,"maxLength":20}},"additionalProperties":false}},"completions":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"employeeId":{"type":"string","minLength":1,"maxLength":80},"requirementId":{"type":"string","minLength":1,"maxLength":80}},"additionalProperties":false}},"requirements":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":40}},"required":["field"],"additionalProperties":false}},"text":{"type":"string","minLength":1,"maxLength":20000},"csv":{"type":"string","minLength":1,"maxLength":200000},"json":{"type":"string","minLength":1,"maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/csv","application/json","text/plain"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"roleText":{"type":"string","minLength":1,"maxLength":20000},"employeeText":{"type":"string","minLength":1,"maxLength":20000},"asOf":{"type":"string","minLength":1,"maxLength":10},"withinDays":{"type":"integer","minimum":1,"maximum":3650}},"additionalProperties":false},"example":{"asOf":"2026-11-03","withinDays":30,"documents":[{"employeeId":"E-100","type":"passport","identifier":"AB1234567","expiresOn":"2020-06-01"},{"employeeId":"E-100","type":"visa","identifier":"CD7654321","expiresOn":"2026-11-20"}]}}}},"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. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"legalCompliance":{"type":"boolean"},"employmentDecision":{"type":"boolean"},"accessChanged":{"type":"boolean"},"status":{"type":"string"},"asOf":{"type":"string"},"withinDays":{"type":"number"},"documents":{"type":"array","items":{"type":"object","properties":{"employeeId":{"type":"string"},"type":{"type":"string"},"identifierMasked":{"type":"string"},"expiresOn":{"type":"string"},"status":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"issues":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-03T13:00:00.000Z","legalCompliance":false,"employmentDecision":false,"accessChanged":false,"status":"checked","asOf":"2026-11-03","withinDays":30,"documents":[{"employeeId":"E-100","type":"passport","identifierMasked":"••••4567","expiresOn":"2020-06-01","status":"expired","detail":"The expiry date is before 2026-11-03."},{"employeeId":"E-100","type":"visa","identifierMasked":"••••4321","expiresOn":"2026-11-20","status":"due","detail":"The expiry date falls within the supplied 30-day window."}],"issues":[],"limitations":["No employment decision is made and no access is changed.","Employment law requirements are not invented. Checklist items come only from supplied policies.","This result is not a legal compliance determination.","Document numbers are masked, and email addresses are not copied into the response.","A missing item means it was not in the request."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/hr-operations/record-completeness-report":{"post":{"operationId":"report_personnel_record_completeness","summary":"Report personnel record completeness","description":"Combine supplied records, document dates, policy acknowledgements, onboarding and offboarding items, and role duties. The report does not determine legal compliance or change access.","tags":["hr-operations"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"employees":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"name":{"type":"string","minLength":1,"maxLength":120},"role":{"type":"string","minLength":1,"maxLength":120},"startDate":{"type":"string","minLength":1,"maxLength":20},"endDate":{"type":"string","minLength":1,"maxLength":20},"email":{"type":"string","minLength":1,"maxLength":254}},"additionalProperties":false}},"documents":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"employeeId":{"type":"string","minLength":1,"maxLength":80},"type":{"type":"string","minLength":1,"maxLength":80},"identifier":{"type":"string","minLength":1,"maxLength":80},"issuedOn":{"type":"string","minLength":1,"maxLength":20},"expiresOn":{"type":"string","minLength":1,"maxLength":20}},"additionalProperties":false}},"policies":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"stage":{"type":"string","minLength":1,"maxLength":40},"name":{"type":"string","minLength":1,"maxLength":160},"kind":{"type":"string","minLength":1,"maxLength":40},"match":{"type":"string","minLength":1,"maxLength":80},"effectiveOn":{"type":"string","minLength":1,"maxLength":20}},"additionalProperties":false}},"acknowledgements":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"employeeId":{"type":"string","minLength":1,"maxLength":80},"policyId":{"type":"string","minLength":1,"maxLength":80},"acknowledgedOn":{"type":"string","minLength":1,"maxLength":20}},"additionalProperties":false}},"completions":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"employeeId":{"type":"string","minLength":1,"maxLength":80},"requirementId":{"type":"string","minLength":1,"maxLength":80}},"additionalProperties":false}},"requirements":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":40}},"required":["field"],"additionalProperties":false}},"text":{"type":"string","minLength":1,"maxLength":20000},"csv":{"type":"string","minLength":1,"maxLength":200000},"json":{"type":"string","minLength":1,"maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/csv","application/json","text/plain"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"roleText":{"type":"string","minLength":1,"maxLength":20000},"employeeText":{"type":"string","minLength":1,"maxLength":20000},"asOf":{"type":"string","minLength":1,"maxLength":10},"withinDays":{"type":"integer","minimum":1,"maximum":3650}},"additionalProperties":false},"example":{"asOf":"2026-11-03","withinDays":30,"employees":[{"id":"E-100","name":"Ada Lovelace","role":"Engineer","startDate":"2024-01-15","endDate":"2023-01-01"}],"documents":[{"employeeId":"E-100","type":"passport","identifier":"AB1234567","issuedOn":"2019-01-01","expiresOn":"2020-06-01"}],"requirements":[{"field":"email"}],"policies":[{"id":"P1","stage":"onboarding","name":"Identification","kind":"document","match":"passport"},{"id":"P2","stage":"onboarding","name":"Handbook","kind":"policy"},{"id":"P3","stage":"offboarding","name":"Return equipment","kind":"task"},{"id":"P4","stage":"acknowledgement","name":"Safety handbook","kind":"policy","effectiveOn":"2026-06-01"}],"acknowledgements":[{"employeeId":"E-100","policyId":"P4","acknowledgedOn":"2026-01-01"}],"roleText":"Title: Engineer\nDuty: Operate the press\nDuty: Train new operators\n","employeeText":"Title: Engineer\nDuty: Operate the press\nDuty: Sweep the floor\n"}}}},"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. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"legalCompliance":{"type":"boolean"},"employmentDecision":{"type":"boolean"},"accessChanged":{"type":"boolean"},"status":{"type":"string"},"employeeCount":{"type":"number"},"documentCount":{"type":"number"},"asOf":{"type":"string"},"withinDays":{"type":"number"},"employees":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"startDate":{"type":"string"},"endDate":{"type":"string"}},"additionalProperties":true}},"documents":{"type":"array","items":{"type":"object","properties":{"employeeId":{"type":"string"},"type":{"type":"string"},"identifierMasked":{"type":"string"},"issuedOn":{"type":"string"},"expiresOn":{"type":"string"}},"additionalProperties":true}},"records":{"type":"array","items":{"type":"object","properties":{"employeeId":{"type":"string"},"status":{"type":"string"},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"conflicts":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}}},"additionalProperties":true}},"acknowledgements":{"type":"array","items":{"type":"object","properties":{"employeeId":{"type":"string"},"policyId":{"type":"string"},"policyName":{"type":"string"},"status":{"type":"string"},"acknowledgedOn":{"type":"string"},"effectiveOn":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"onboarding":{"type":"array","items":{"type":"object","properties":{"employeeId":{"type":"string"},"requirementId":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string"},"status":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"offboarding":{"type":"array","items":{"type":"object","properties":{"employeeId":{"type":"string"},"requirementId":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string"},"status":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"expiry":{"type":"array","items":{"type":"object","properties":{"employeeId":{"type":"string"},"type":{"type":"string"},"identifierMasked":{"type":"string"},"expiresOn":{"type":"string"},"status":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"roleTitle":{"type":"string"},"employeeTitle":{"type":"string"},"matched":{"type":"array","items":{"type":"object","properties":{"duty":{"type":"string"}},"additionalProperties":true}},"missing":{"type":"array","items":{"type":"object","properties":{"duty":{"type":"string"}},"additionalProperties":true}},"extra":{"type":"array","items":{"type":"object","properties":{"duty":{"type":"string"}},"additionalProperties":true}},"issues":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-03T13:00:00.000Z","legalCompliance":false,"employmentDecision":false,"accessChanged":false,"status":"checked","employeeCount":1,"documentCount":1,"asOf":"2026-11-03","withinDays":30,"employees":[{"id":"E-100","name":"Ada Lovelace","role":"Engineer","startDate":"2024-01-15","endDate":"2023-01-01"}],"documents":[{"employeeId":"E-100","type":"passport","identifierMasked":"••••4567","issuedOn":"2019-01-01","expiresOn":"2020-06-01"}],"records":[{"employeeId":"E-100","status":"conflict","missing":[{"field":"email","detail":"The required email was not supplied."}],"conflicts":[{"field":"endDate","detail":"The end date is before the start date. The dates were not rewritten."}]}],"acknowledgements":[{"employeeId":"E-100","policyId":"P4","policyName":"Safety handbook","status":"stale","acknowledgedOn":"2026-01-01","effectiveOn":"2026-06-01","detail":"The acknowledgement date is before the supplied policy date. The policy was not treated as current."}],"onboarding":[{"employeeId":"E-100","requirementId":"P1","name":"Identification","kind":"document","status":"met","detail":"A supplied document record matches this policy."},{"employeeId":"E-100","requirementId":"P2","name":"Handbook","kind":"policy","status":"missing","detail":"No supplied policy record matches this policy."}],"offboarding":[{"employeeId":"E-100","requirementId":"P3","name":"Return equipment","kind":"task","status":"missing","detail":"No supplied task record matches this policy. Access was not changed."}],"expiry":[{"employeeId":"E-100","type":"passport","identifierMasked":"••••4567","expiresOn":"2020-06-01","status":"expired","detail":"The expiry date is before 2026-11-03."}],"roleTitle":"Engineer","employeeTitle":"Engineer","matched":[{"duty":"Operate the press"}],"missing":[{"duty":"Train new operators"}],"extra":[{"duty":"Sweep the floor"}],"issues":[],"limitations":["No employment decision is made and no access is changed.","Employment law requirements are not invented. Checklist items come only from supplied policies.","This result is not a legal compliance determination.","Document numbers are masked, and email addresses are not copied into the response.","A missing item means it was not in the request."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.12"},"protocols":[{"x402":{}}]}}}},"components":{"schemas":{"ApiError":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}