{"uid":"cap_2F0slVZYgaq4aIuc4qp76","slug":"brainiac-vendor-compliance-subcontractor-payment-readiness-check-2d3313f2","name":"BRAINIAC Vendor Compliance – Subcontractor Payment Readiness 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/vendor-compliance/subcontractor-payment-readiness?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"asOf":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"vendor":{"type":"object","required":["legalName"],"properties":{"address":{"type":"string","maxLength":300,"minLength":1},"country":{"type":"string","maxLength":80,"minLength":2},"legalName":{"type":"string","maxLength":200,"minLength":1},"reference":{"type":"string","maxLength":80,"minLength":1},"contactName":{"type":"string","maxLength":200,"minLength":1},"contactEmail":{"type":"string","maxLength":200,"minLength":3},"safetyRecord":{"type":"string","maxLength":500,"minLength":1},"bondingCapacity":{"type":"number","maximum":1000000000000,"minimum":0},"yearsInBusiness":{"type":"number","maximum":200,"minimum":0},"identifierPresent":{"type":"boolean"}},"additionalProperties":false},"documents":{"type":"array","items":{"type":"object","required":["id","type"],"properties":{"id":{"type":"string","maxLength":80,"minLength":1},"type":{"type":"string","maxLength":80,"minLength":1},"title":{"type":"string","maxLength":200,"minLength":1},"issuedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"expiresOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"licenseType":{"type":"string","maxLength":120,"minLength":1},"jurisdiction":{"type":"string","maxLength":40,"minLength":1},"completedCeHours":{"type":"number","maximum":1000,"minimum":0},"certificateFields":{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string","maxLength":80,"minLength":1},"value":{"type":"string","maxLength":200},"confidence":{"type":"number","maximum":1,"minimum":0}},"additionalProperties":false},"maxItems":40}},"additionalProperties":false},"maxItems":40},"openItems":{"type":"array","items":{"type":"object","required":["id","name","status"],"properties":{"id":{"type":"string","maxLength":80,"minLength":1},"name":{"type":"string","maxLength":200,"minLength":1},"status":{"enum":["satisfied","missing_evidence","expired","failed","not_verified"],"type":"string"}},"additionalProperties":false},"maxItems":40},"projectName":{"type":"string","maxLength":200,"minLength":1},"requirements":{"type":"array","items":{"type":"object","required":["id","kind","name"],"properties":{"id":{"type":"string","maxLength":80,"minLength":1},"kind":{"enum":["field","document","insurance","licence","attestation","criterion"],"type":"string"},"name":{"type":"string","maxLength":200,"minLength":1},"field":{"type":"string","maxLength":40,"minLength":1},"minimum":{"type":"number"},"expected":{"type":"string","maxLength":200,"minLength":1},"required":{"type":"boolean"},"insurance":{"type":"object","properties":{"effectiveOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"expiresAfter":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"namedInsured":{"type":"string","maxLength":200},"generalLiability":{"type":"object","properties":{"aggregate":{"type":"number","minimum":0},"eachOccurrence":{"type":"number","minimum":0}},"additionalProperties":false},"additionalInsured":{"type":"boolean"},"umbrellaLiability":{"type":"object","properties":{"aggregate":{"type":"number","minimum":0},"eachOccurrence":{"type":"number","minimum":0}},"additionalProperties":false},"automobileLiability":{"type":"object","properties":{"combinedSingleLimit":{"type":"number","minimum":0}},"additionalProperties":false},"waiverOfSubrogation":{"type":"boolean"},"workersCompensation":{"type":"object","properties":{"statutory":{"type":"boolean"},"employerLiability":{"type":"number","minimum":0}},"additionalProperties":false}},"additionalProperties":false},"documentId":{"type":"string","maxLength":80,"minLength":1},"evidenceId":{"type":"string","maxLength":80,"minLength":1},"minCeHours":{"type":"number","maximum":1000,"minimum":0},"licenseType":{"type":"string","maxLength":120,"minLength":1},"documentType":{"type":"string","maxLength":80,"minLength":1},"expiresAfter":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"jurisdiction":{"type":"string","maxLength":40,"minLength":1}},"additionalProperties":false},"maxItems":40,"minItems":1}}},"responseSchema":{"type":"json","example":{"asOf":"2026-11-02","counts":{"failed":0,"expired":0,"satisfied":0,"not_verified":0,"missing_evidence":2},"vendor":{"legalName":"Example Construction LLC","reference":"V-100","normalizedName":"example construction"},"purpose":"subcontractor-payment-readiness","summary":"One or more required items are missing, expired, or failed. Complete the remediation steps before continuing.","findings":[{"id":"payroll","kind":"open_item","name":"Certified payroll","source":"Caller-supplied open item. The underlying screen was not run again.","status":"missing_evidence","observed":"missing_evidence","required":true,"remediation":"Provide the missing evidence for Certified payroll before payment."},{"id":"waiver","kind":"document","name":"Lien waiver","source":"Supplied document inventory","status":"missing_evidence","observed":"missing_evidence","required":true,"remediation":"Add the missing lien_waiver document to the package before continuing."}],"warnings":["asOf was not supplied. The check used UTC date 2026-11-02."],"checkedAt":"2026-11-02T19:00:00.000Z","assessment":"requirements_unmet","limitations":["Payment readiness lists missing documents and caller-supplied open items. It does not release a payment."],"projectName":"Example project","blocksWorkflow":true}},"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_CFbYJBUljaskbz2ZPCmrn","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":"Evaluates whether a subcontractor vendor meets all required compliance conditions (documents, open items, and checklist requirements) before a payment can be released on a construction or contracting project.","exampleAgentPrompt":"Before we release the payment to Apex Roofing LLC (vendor ref V-220) on the Harbor Bridge project, can you run a payment readiness check and tell me if their lien waiver and certified payroll documents are in order as of today?","exampleUseCases":[{"title":"Pre-payment compliance gate for subcontractor","prompt":"We're about to pay Summit Concrete Inc. (reference V-105) for work on the Riverside Office project. Can you check whether their compliance package is complete — specifically their lien waiver and insurance certificate — and tell me if anything is blocking the payment as of today?"},{"title":"Flagging expired documents before invoice approval","prompt":"I need to review Greenfield Electric's payment readiness for the downtown retrofit project before we approve their invoice. Their reference is V-312. Flag any expired licenses or missing documents and give me the remediation steps."},{"title":"Automated compliance pre-screening in a payment workflow","prompt":"As part of our automated payment pipeline, check whether vendor Mesa Plumbing LLC (V-089) in the US satisfies all subcontractor payment requirements for the Lakeview Development project as of 2025-07-15, including certified payroll, lien waiver, and their contractor license."}],"resultDescription":"Returns a structured JSON object with an overall assessment verdict (e.g. 'requirements_unmet' or 'requirements_met'), a count of satisfied/missing/expired/failed items, a findings array detailing each requirement's status and remediation instructions, a flag indicating whether the workflow is blocked, and any warnings about input data quality.","failureModes":["Missing required vendor legalName field returns a 400 validation error","Malformed date pattern for asOf (not YYYY-MM-DD) causes input rejection","Too many documents or open items (over 40 each) triggers an array limit error","Ambiguous or missing document types result in findings marked 'not_verified' rather than 'satisfied'","If asOf is omitted, the check defaults to UTC today and emits a warning"],"whenToPreferThis":"Use this endpoint when an AI agent or automated payment workflow needs to gate a subcontractor payment on a compliance checklist — checking for lien waivers, certified payroll, insurance, licenses, and other open items — before releasing funds. Prefer this over a generic document-storage lookup when you need a structured pass/fail verdict with per-item remediation guidance, especially in construction or contracting contexts where regulatory compliance is mandatory.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-17T00:35:38.212Z","isFirstParty":false,"canonicalSlug":"brainiac-vendor-compliance-subcontractor-payment-readiness-check-2d3313f2"}