{"uid":"cap_j6UZHzBsmzjwfjDZu3nph","slug":"brainiac-job-role-description-compare-e76faead","name":"BRAINIAC Job Role Description Compare","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/job-role-description-compare?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":{"extra":[{"duty":"Sweep the floor"}],"issues":[],"status":"compared","matched":[{"duty":"Operate the press"}],"missing":[{"duty":"Train new operators"}],"checkedAt":"2026-11-03T13:00:00.000Z","roleTitle":"Press operator","limitations":["No employment decision is made and no access is changed.","Employment law requirements are not invented. Checklist items come only from supplied policies.","…"],"accessChanged":false,"employeeTitle":"Press operator","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_-DPjF1T012ZUghQocRdWH","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":"Compares an employee's actual duties (from supplied text, CSV, or JSON) against a job role description and policies, returning matched, missing, and extra duties with caveats","exampleAgentPrompt":"Compare this press operator's actual duties — 'Operate the press, Sweep the floor' — against the official Press Operator role description 'Operate the press, Train new operators' as of 2026-11-03, and tell me what's matched, missing, or extra.","exampleUseCases":[{"title":"Job description gap audit","prompt":"I have a list of tasks our warehouse coordinator is actually doing day-to-day — can you compare it against the official Warehouse Coordinator job description we have on file and tell me which duties are missing from the description, which match, and which are extras we didn't account for?"},{"title":"New hire onboarding role check","prompt":"We just onboarded a new software engineer and I want to verify their assigned duties match what's in the official Software Engineer role description — can you compare the two and flag any discrepancies as of today?"},{"title":"Policy-driven role compliance review","prompt":"I have our HR policies and an employee's current responsibilities listed in a CSV — please check how well this Marketing Manager's actual tasks align with the role description defined in those policies and show me what's matched, missing, or extra."}],"resultDescription":"A JSON object containing: status ('compared'), roleTitle and employeeTitle, arrays of matched duties (duties in both description and submission), missing duties (in description but not submitted), and extra duties (submitted but not in description), a checkedAt timestamp, accessChanged (boolean), employmentDecision (boolean), legalCompliance (boolean), and a limitations array with important caveats about the nature of the comparison.","failureModes":["Missing required input: no roleText, csv, json, or text supplied — returns validation error","Input too large: text or CSV exceeds character limits — returns size error","Malformed JSON in json field — returns parse error","No distinguishable duties found in input — may return empty matched/missing/extra arrays","Ambiguous role title — comparison may be less precise","Payment not completed via x402 — returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need a structured, policy-aware comparison between a formal job role description and an employee's actual or listed duties — especially when you want to surface gaps, extras, and matches without making employment decisions or legal compliance claims. Prefer this over generic text-diff tools when HR policy context matters and you need a clearly labeled HR-domain output with built-in caveats.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-17T00:36:59.371Z","isFirstParty":false,"canonicalSlug":"brainiac-job-role-description-compare-e76faead"}