{"uid":"cap_VVKPL_3sngYzxAaUv8buu","slug":"brainiac-workforce-document-expiry-check-2412a5b9","name":"BRAINIAC Workforce Document Expiry Check","description":"Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.","url":"https://www.brainiac.software/api/v1/hr-operations/workforce-document-expiry-check?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"csv":{"type":"string","maxLength":200000,"minLength":1},"asOf":{"type":"string","maxLength":10,"minLength":1},"file":{"type":"object","required":["mediaType","fileBase64"],"properties":{"filename":{"type":"string","maxLength":180,"minLength":1},"mediaType":{"enum":["text/csv","application/json","text/plain"],"type":"string"},"fileBase64":{"type":"string","maxLength":12000000,"minLength":1}},"additionalProperties":false},"json":{"type":"string","maxLength":200000,"minLength":1},"text":{"type":"string","maxLength":20000,"minLength":1},"policies":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80,"minLength":1},"kind":{"type":"string","maxLength":40,"minLength":1},"name":{"type":"string","maxLength":160,"minLength":1},"match":{"type":"string","maxLength":80,"minLength":1},"stage":{"type":"string","maxLength":40,"minLength":1},"effectiveOn":{"type":"string","maxLength":20,"minLength":1}},"additionalProperties":false},"maxItems":100},"roleText":{"type":"string","maxLength":20000,"minLength":1},"documents":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","maxLength":80,"minLength":1},"issuedOn":{"type":"string","maxLength":20,"minLength":1},"expiresOn":{"type":"string","maxLength":20,"minLength":1},"employeeId":{"type":"string","maxLength":80,"minLength":1},"identifier":{"type":"string","maxLength":80,"minLength":1}},"additionalProperties":false},"maxItems":400},"employees":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80,"minLength":1},"name":{"type":"string","maxLength":120,"minLength":1},"role":{"type":"string","maxLength":120,"minLength":1},"email":{"type":"string","maxLength":254,"minLength":1},"endDate":{"type":"string","maxLength":20,"minLength":1},"startDate":{"type":"string","maxLength":20,"minLength":1}},"additionalProperties":false},"maxItems":200},"withinDays":{"type":"integer","maximum":3650,"minimum":1},"completions":{"type":"array","items":{"type":"object","properties":{"employeeId":{"type":"string","maxLength":80,"minLength":1},"requirementId":{"type":"string","maxLength":80,"minLength":1}},"additionalProperties":false},"maxItems":400},"employeeText":{"type":"string","maxLength":20000,"minLength":1},"requirements":{"type":"array","items":{"type":"object","required":["field"],"properties":{"field":{"type":"string","maxLength":40,"minLength":1}},"additionalProperties":false},"maxItems":20},"acknowledgements":{"type":"array","items":{"type":"object","properties":{"policyId":{"type":"string","maxLength":80,"minLength":1},"employeeId":{"type":"string","maxLength":80,"minLength":1},"acknowledgedOn":{"type":"string","maxLength":20,"minLength":1}},"additionalProperties":false},"maxItems":400}}},"responseSchema":{"type":"json","example":{"asOf":"2026-11-03","issues":[],"status":"checked","checkedAt":"2026-11-03T13:00:00.000Z","documents":[{"type":"passport","detail":"The expiry date is before 2026-11-03.","status":"expired","expiresOn":"2020-06-01","employeeId":"E-100","identifierMasked":"••••4567"},{"type":"visa","detail":"The expiry date falls within the supplied 30-day window.","status":"due","expiresOn":"2026-11-20","employeeId":"E-100","identifierMasked":"••••4321"}],"withinDays":30,"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."],"accessChanged":false,"legalCompliance":false,"employmentDecision":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_XaihRAQiPOuyEPMpD7VgT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks employee identity and work-authorization documents against an as-of date and optional policies, returning expired and soon-to-expire documents with masked identifiers","exampleAgentPrompt":"Check all our employee documents and flag anything that's expired or expiring within the next 30 days as of today — here's the list of employees and their passport and visa details in JSON format.","exampleUseCases":[{"title":"Pre-audit visa expiry sweep","prompt":"We have an HR compliance review next week — can you check all 150 employees' work visas and passports as of November 3 2026 and tell me which ones have already expired or will expire within 60 days? I'll paste the employee and document data as JSON."},{"title":"Onboarding document readiness check","prompt":"Before we finalize onboarding for the new hires starting December 1, can you check whether any of their passports or right-to-work documents are expiring within the next 90 days? Here's a CSV with their document info and the as-of date should be December 1 2026."},{"title":"Automated monthly compliance flag","prompt":"Run our monthly document expiry check using this month's workforce data — flag anything that's already expired or coming up within the next 30 days as of today, and apply our standard visa-renewal policy rules so I know which ones trigger an action."}],"resultDescription":"Returns a JSON object listing each document with its status (expired, due, or valid), expiry date, masked identifier, and employee ID, plus a top-level status field, the as-of date used, the withinDays window, any policy-driven issues, and a limitations array clarifying that no employment decision, access change, or legal compliance determination is made.","failureModes":["Missing required asOf date — returns validation error","No documents or employees provided — returns empty document list with checked status","Document dates in unrecognized format — parsing failure or incorrect status","Exceeding maxItems limits (400 documents, 200 employees) — request rejected","File base64 too large (>12MB) or wrong mediaType — schema validation error","Malformed CSV or JSON input string — parse error returned"],"whenToPreferThis":"Use this endpoint when you need a lightweight, no-account, pay-per-call document expiry audit across a workforce roster without integrating a full HRMS. It is ideal for agents running periodic compliance sweeps, pre-audit checks, or onboarding readiness validations where you already have employee and document data structured or in CSV/JSON form. Prefer it over building custom date-comparison logic when you also want policy-aware flagging and masked-identifier output suitable for sharing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-16T18:39:45.136Z","isFirstParty":false,"canonicalSlug":"brainiac-workforce-document-expiry-check-2412a5b9"}