{"openapi":"3.1.0","info":{"title":"Vendor & Contractor Compliance API","version":"1.0.0","description":"Package checks for onboarding, prequalification, payment readiness, document completeness, closeout, and a consolidated report. Results come from the supplied record and buyer 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 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/vendor-compliance/onboarding-precheck":{"post":{"operationId":"precheck_vendor_onboarding","summary":"Precheck vendor onboarding","description":"Compare a supplied vendor record, document list, and attestations with the buyer requirements. Missing, expired, failed, and unverified items are reported separately.","tags":["vendor-compliance"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"asOf":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"projectName":{"type":"string","minLength":1,"maxLength":200},"vendor":{"type":"object","properties":{"legalName":{"type":"string","minLength":1,"maxLength":200},"reference":{"type":"string","minLength":1,"maxLength":80},"country":{"type":"string","minLength":2,"maxLength":80},"identifierPresent":{"type":"boolean"},"contactName":{"type":"string","minLength":1,"maxLength":200},"contactEmail":{"type":"string","minLength":3,"maxLength":200},"address":{"type":"string","minLength":1,"maxLength":300},"yearsInBusiness":{"type":"number","minimum":0,"maximum":200},"bondingCapacity":{"type":"number","minimum":0,"maximum":1000000000000},"safetyRecord":{"type":"string","minLength":1,"maxLength":500}},"required":["legalName"],"additionalProperties":false},"documents":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"type":{"type":"string","minLength":1,"maxLength":80},"title":{"type":"string","minLength":1,"maxLength":200},"issuedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"expiresOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"jurisdiction":{"type":"string","minLength":1,"maxLength":40},"licenseType":{"type":"string","minLength":1,"maxLength":120},"completedCeHours":{"type":"number","minimum":0,"maximum":1000},"certificateFields":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"value":{"type":"string","maxLength":200},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["name"],"additionalProperties":false}}},"required":["id","type"],"additionalProperties":false}},"requirements":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"kind":{"type":"string","enum":["field","document","insurance","licence","attestation","criterion"]},"name":{"type":"string","minLength":1,"maxLength":200},"required":{"type":"boolean"},"field":{"type":"string","minLength":1,"maxLength":40},"documentType":{"type":"string","minLength":1,"maxLength":80},"documentId":{"type":"string","minLength":1,"maxLength":80},"evidenceId":{"type":"string","minLength":1,"maxLength":80},"expiresAfter":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"jurisdiction":{"type":"string","minLength":1,"maxLength":40},"licenseType":{"type":"string","minLength":1,"maxLength":120},"minCeHours":{"type":"number","minimum":0,"maximum":1000},"minimum":{"type":"number"},"expected":{"type":"string","minLength":1,"maxLength":200},"insurance":{"type":"object","properties":{"namedInsured":{"type":"string","maxLength":200},"effectiveOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"expiresAfter":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"generalLiability":{"type":"object","properties":{"eachOccurrence":{"type":"number","minimum":0},"aggregate":{"type":"number","minimum":0}},"additionalProperties":false},"workersCompensation":{"type":"object","properties":{"statutory":{"type":"boolean"},"employerLiability":{"type":"number","minimum":0}},"additionalProperties":false},"automobileLiability":{"type":"object","properties":{"combinedSingleLimit":{"type":"number","minimum":0}},"additionalProperties":false},"umbrellaLiability":{"type":"object","properties":{"eachOccurrence":{"type":"number","minimum":0},"aggregate":{"type":"number","minimum":0}},"additionalProperties":false},"additionalInsured":{"type":"boolean"},"waiverOfSubrogation":{"type":"boolean"}},"additionalProperties":false}},"required":["id","kind","name"],"additionalProperties":false}},"attestations":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"statement":{"type":"string","minLength":1,"maxLength":500},"accepted":{"type":"boolean"},"acceptedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["id","statement","accepted"],"additionalProperties":false}}},"required":["vendor"],"additionalProperties":false},"example":{"asOf":"2026-11-02","projectName":"Example project","vendor":{"legalName":"Example Construction LLC","country":"USA","contactEmail":"ap@example.com","identifierPresent":true},"documents":[{"id":"ins-1","type":"insurance_certificate","expiresOn":"2026-01-01"}],"requirements":[{"id":"gl-doc","kind":"document","name":"Insurance certificate","documentType":"insurance_certificate","expiresAfter":"2026-12-31"}]}}}},"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"},"asOf":{"type":"string"},"purpose":{"type":"string"},"projectName":{"type":"string"},"vendor":{"type":"object","properties":{"legalName":{"type":"string"},"normalizedName":{"type":"string"},"reference":{"type":"string"}},"additionalProperties":true},"assessment":{"type":"string"},"blocksWorkflow":{"type":"boolean"},"summary":{"type":"string"},"counts":{"type":"object","properties":{"satisfied":{"type":"number"},"missing_evidence":{"type":"number"},"expired":{"type":"number"},"failed":{"type":"number"},"not_verified":{"type":"number"}},"additionalProperties":true},"findings":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string"},"required":{"type":"boolean"},"status":{"type":"string"},"observed":{"type":"string"},"remediation":{"type":"string"},"source":{"type":"string"}},"additionalProperties":true}},"warnings":{"type":"array","items":{"type":"string"}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-02T19:00:00.000Z","asOf":"2026-11-02","purpose":"vendor-onboarding-precheck","projectName":"Example project","vendor":{"legalName":"Example Construction LLC","normalizedName":"example construction","reference":"V-100"},"assessment":"requirements_unmet","blocksWorkflow":true,"summary":"One or more required items are missing, expired, or failed. Complete the remediation steps before continuing.","counts":{"satisfied":0,"missing_evidence":0,"expired":1,"failed":0,"not_verified":0},"findings":[{"id":"gl-doc","name":"Insurance certificate","kind":"document","required":true,"status":"expired","observed":"2026-01-01","remediation":"Replace document ins-1. It expired on 2026-01-01, before the check date 2026-11-02.","source":"Supplied document inventory"}],"warnings":["asOf was not supplied. The check used UTC date 2026-11-02."],"limitations":["The result uses the supplied package and buyer requirements. Licensing boards, sanctions lists, wage determinations, and insurers are not contacted."]}}}},"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/vendor-compliance/contractor-prequalification":{"post":{"operationId":"prequalify_a_contractor","summary":"Prequalify a contractor","description":"Compare buyer qualification criteria with supplied vendor facts, documents, and evidence. The result does not award eligibility or query a registry.","tags":["vendor-compliance"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"asOf":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"projectName":{"type":"string","minLength":1,"maxLength":200},"vendor":{"type":"object","properties":{"legalName":{"type":"string","minLength":1,"maxLength":200},"reference":{"type":"string","minLength":1,"maxLength":80},"country":{"type":"string","minLength":2,"maxLength":80},"identifierPresent":{"type":"boolean"},"contactName":{"type":"string","minLength":1,"maxLength":200},"contactEmail":{"type":"string","minLength":3,"maxLength":200},"address":{"type":"string","minLength":1,"maxLength":300},"yearsInBusiness":{"type":"number","minimum":0,"maximum":200},"bondingCapacity":{"type":"number","minimum":0,"maximum":1000000000000},"safetyRecord":{"type":"string","minLength":1,"maxLength":500}},"required":["legalName"],"additionalProperties":false},"documents":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"type":{"type":"string","minLength":1,"maxLength":80},"title":{"type":"string","minLength":1,"maxLength":200},"issuedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"expiresOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"jurisdiction":{"type":"string","minLength":1,"maxLength":40},"licenseType":{"type":"string","minLength":1,"maxLength":120},"completedCeHours":{"type":"number","minimum":0,"maximum":1000},"certificateFields":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"value":{"type":"string","maxLength":200},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["name"],"additionalProperties":false}}},"required":["id","type"],"additionalProperties":false}},"requirements":{"minItems":1,"maxItems":40,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"kind":{"type":"string","enum":["field","document","insurance","licence","attestation","criterion"]},"name":{"type":"string","minLength":1,"maxLength":200},"required":{"type":"boolean"},"field":{"type":"string","minLength":1,"maxLength":40},"documentType":{"type":"string","minLength":1,"maxLength":80},"documentId":{"type":"string","minLength":1,"maxLength":80},"evidenceId":{"type":"string","minLength":1,"maxLength":80},"expiresAfter":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"jurisdiction":{"type":"string","minLength":1,"maxLength":40},"licenseType":{"type":"string","minLength":1,"maxLength":120},"minCeHours":{"type":"number","minimum":0,"maximum":1000},"minimum":{"type":"number"},"expected":{"type":"string","minLength":1,"maxLength":200},"insurance":{"type":"object","properties":{"namedInsured":{"type":"string","maxLength":200},"effectiveOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"expiresAfter":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"generalLiability":{"type":"object","properties":{"eachOccurrence":{"type":"number","minimum":0},"aggregate":{"type":"number","minimum":0}},"additionalProperties":false},"workersCompensation":{"type":"object","properties":{"statutory":{"type":"boolean"},"employerLiability":{"type":"number","minimum":0}},"additionalProperties":false},"automobileLiability":{"type":"object","properties":{"combinedSingleLimit":{"type":"number","minimum":0}},"additionalProperties":false},"umbrellaLiability":{"type":"object","properties":{"eachOccurrence":{"type":"number","minimum":0},"aggregate":{"type":"number","minimum":0}},"additionalProperties":false},"additionalInsured":{"type":"boolean"},"waiverOfSubrogation":{"type":"boolean"}},"additionalProperties":false}},"required":["id","kind","name"],"additionalProperties":false}},"evidence":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"value":{"type":"string","minLength":1,"maxLength":500}},"required":["id","value"],"additionalProperties":false}}},"required":["vendor","requirements"],"additionalProperties":false},"example":{"asOf":"2026-11-02","vendor":{"legalName":"Example Construction LLC","yearsInBusiness":3},"requirements":[{"id":"years","kind":"field","name":"Years in business","field":"yearsInBusiness","minimum":5}]}}}},"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"},"asOf":{"type":"string"},"purpose":{"type":"string"},"projectName":{"type":"string"},"vendor":{"type":"object","properties":{"legalName":{"type":"string"},"normalizedName":{"type":"string"},"reference":{"type":"string"}},"additionalProperties":true},"assessment":{"type":"string"},"blocksWorkflow":{"type":"boolean"},"summary":{"type":"string"},"counts":{"type":"object","properties":{"satisfied":{"type":"number"},"missing_evidence":{"type":"number"},"expired":{"type":"number"},"failed":{"type":"number"},"not_verified":{"type":"number"}},"additionalProperties":true},"findings":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string"},"required":{"type":"boolean"},"status":{"type":"string"},"observed":{"type":"string"},"remediation":{"type":"string"},"source":{"type":"string"}},"additionalProperties":true}},"warnings":{"type":"array","items":{"type":"string"}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-02T19:00:00.000Z","asOf":"2026-11-02","purpose":"contractor-prequalification","projectName":"Example project","vendor":{"legalName":"Example Construction LLC","normalizedName":"example construction","reference":"V-100"},"assessment":"requirements_unmet","blocksWorkflow":true,"summary":"One or more required items are missing, expired, or failed. Complete the remediation steps before continuing.","counts":{"satisfied":0,"missing_evidence":0,"expired":0,"failed":1,"not_verified":0},"findings":[{"id":"years","name":"Years in business","kind":"field","required":true,"status":"failed","observed":"3","remediation":"Raise Years in business to at least 5, or submit evidence that the buyer minimum does not apply. The supplied value is 3.","source":"Supplied vendor record"}],"warnings":["asOf was not supplied. The check used UTC date 2026-11-02."],"limitations":["Prequalification compares buyer criteria with supplied evidence. It does not award eligibility."]}}}},"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/vendor-compliance/subcontractor-payment-readiness":{"post":{"operationId":"check_subcontractor_payment_readiness","summary":"Check subcontractor payment readiness","description":"List missing payment documents and caller-supplied open items. This check does not release a payment or rerun sanctions, wage, or certificate screens.","tags":["vendor-compliance"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"asOf":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"projectName":{"type":"string","minLength":1,"maxLength":200},"vendor":{"type":"object","properties":{"legalName":{"type":"string","minLength":1,"maxLength":200},"reference":{"type":"string","minLength":1,"maxLength":80},"country":{"type":"string","minLength":2,"maxLength":80},"identifierPresent":{"type":"boolean"},"contactName":{"type":"string","minLength":1,"maxLength":200},"contactEmail":{"type":"string","minLength":3,"maxLength":200},"address":{"type":"string","minLength":1,"maxLength":300},"yearsInBusiness":{"type":"number","minimum":0,"maximum":200},"bondingCapacity":{"type":"number","minimum":0,"maximum":1000000000000},"safetyRecord":{"type":"string","minLength":1,"maxLength":500}},"required":["legalName"],"additionalProperties":false},"documents":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"type":{"type":"string","minLength":1,"maxLength":80},"title":{"type":"string","minLength":1,"maxLength":200},"issuedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"expiresOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"jurisdiction":{"type":"string","minLength":1,"maxLength":40},"licenseType":{"type":"string","minLength":1,"maxLength":120},"completedCeHours":{"type":"number","minimum":0,"maximum":1000},"certificateFields":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"value":{"type":"string","maxLength":200},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["name"],"additionalProperties":false}}},"required":["id","type"],"additionalProperties":false}},"requirements":{"minItems":1,"maxItems":40,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"kind":{"type":"string","enum":["field","document","insurance","licence","attestation","criterion"]},"name":{"type":"string","minLength":1,"maxLength":200},"required":{"type":"boolean"},"field":{"type":"string","minLength":1,"maxLength":40},"documentType":{"type":"string","minLength":1,"maxLength":80},"documentId":{"type":"string","minLength":1,"maxLength":80},"evidenceId":{"type":"string","minLength":1,"maxLength":80},"expiresAfter":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"jurisdiction":{"type":"string","minLength":1,"maxLength":40},"licenseType":{"type":"string","minLength":1,"maxLength":120},"minCeHours":{"type":"number","minimum":0,"maximum":1000},"minimum":{"type":"number"},"expected":{"type":"string","minLength":1,"maxLength":200},"insurance":{"type":"object","properties":{"namedInsured":{"type":"string","maxLength":200},"effectiveOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"expiresAfter":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"generalLiability":{"type":"object","properties":{"eachOccurrence":{"type":"number","minimum":0},"aggregate":{"type":"number","minimum":0}},"additionalProperties":false},"workersCompensation":{"type":"object","properties":{"statutory":{"type":"boolean"},"employerLiability":{"type":"number","minimum":0}},"additionalProperties":false},"automobileLiability":{"type":"object","properties":{"combinedSingleLimit":{"type":"number","minimum":0}},"additionalProperties":false},"umbrellaLiability":{"type":"object","properties":{"eachOccurrence":{"type":"number","minimum":0},"aggregate":{"type":"number","minimum":0}},"additionalProperties":false},"additionalInsured":{"type":"boolean"},"waiverOfSubrogation":{"type":"boolean"}},"additionalProperties":false}},"required":["id","kind","name"],"additionalProperties":false}},"openItems":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"name":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["satisfied","missing_evidence","expired","failed","not_verified"]}},"required":["id","name","status"],"additionalProperties":false}}},"required":["requirements"],"additionalProperties":false},"example":{"asOf":"2026-11-02","documents":[{"id":"invoice-1","type":"invoice"}],"requirements":[{"id":"waiver","kind":"document","name":"Lien waiver","documentType":"lien_waiver"}],"openItems":[{"id":"payroll","name":"Certified payroll","status":"missing_evidence"}]}}}},"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"},"asOf":{"type":"string"},"purpose":{"type":"string"},"projectName":{"type":"string"},"vendor":{"type":"object","properties":{"legalName":{"type":"string"},"normalizedName":{"type":"string"},"reference":{"type":"string"}},"additionalProperties":true},"assessment":{"type":"string"},"blocksWorkflow":{"type":"boolean"},"summary":{"type":"string"},"counts":{"type":"object","properties":{"satisfied":{"type":"number"},"missing_evidence":{"type":"number"},"expired":{"type":"number"},"failed":{"type":"number"},"not_verified":{"type":"number"}},"additionalProperties":true},"findings":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string"},"required":{"type":"boolean"},"status":{"type":"string"},"observed":{"type":"string"},"remediation":{"type":"string"},"source":{"type":"string"}},"additionalProperties":true}},"warnings":{"type":"array","items":{"type":"string"}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-02T19:00:00.000Z","asOf":"2026-11-02","purpose":"subcontractor-payment-readiness","projectName":"Example project","vendor":{"legalName":"Example Construction LLC","normalizedName":"example construction","reference":"V-100"},"assessment":"requirements_unmet","blocksWorkflow":true,"summary":"One or more required items are missing, expired, or failed. Complete the remediation steps before continuing.","counts":{"satisfied":0,"missing_evidence":2,"expired":0,"failed":0,"not_verified":0},"findings":[{"id":"payroll","name":"Certified payroll","kind":"open_item","required":true,"status":"missing_evidence","observed":"missing_evidence","remediation":"Provide the missing evidence for Certified payroll before payment.","source":"Caller-supplied open item. The underlying screen was not run again."},{"id":"waiver","name":"Lien waiver","kind":"document","required":true,"status":"missing_evidence","observed":"missing_evidence","remediation":"Add the missing lien_waiver document to the package before continuing.","source":"Supplied document inventory"}],"warnings":["asOf was not supplied. The check used UTC date 2026-11-02."],"limitations":["Payment readiness lists missing documents and caller-supplied open items. It does not release a payment."]}}}},"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/vendor-compliance/document-completeness":{"post":{"operationId":"check_vendor_document_completeness","summary":"Check vendor document completeness","description":"Compare a supplied document inventory with a buyer requirements list. Files are not fetched, and a present document is not treated as verified content.","tags":["vendor-compliance"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"asOf":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"projectName":{"type":"string","minLength":1,"maxLength":200},"documents":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"type":{"type":"string","minLength":1,"maxLength":80},"title":{"type":"string","minLength":1,"maxLength":200},"issuedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"expiresOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"jurisdiction":{"type":"string","minLength":1,"maxLength":40},"licenseType":{"type":"string","minLength":1,"maxLength":120},"completedCeHours":{"type":"number","minimum":0,"maximum":1000},"certificateFields":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"value":{"type":"string","maxLength":200},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["name"],"additionalProperties":false}}},"required":["id","type"],"additionalProperties":false}},"requirements":{"minItems":1,"maxItems":40,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"kind":{"type":"string","enum":["field","document","insurance","licence","attestation","criterion"]},"name":{"type":"string","minLength":1,"maxLength":200},"required":{"type":"boolean"},"field":{"type":"string","minLength":1,"maxLength":40},"documentType":{"type":"string","minLength":1,"maxLength":80},"documentId":{"type":"string","minLength":1,"maxLength":80},"evidenceId":{"type":"string","minLength":1,"maxLength":80},"expiresAfter":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"jurisdiction":{"type":"string","minLength":1,"maxLength":40},"licenseType":{"type":"string","minLength":1,"maxLength":120},"minCeHours":{"type":"number","minimum":0,"maximum":1000},"minimum":{"type":"number"},"expected":{"type":"string","minLength":1,"maxLength":200},"insurance":{"type":"object","properties":{"namedInsured":{"type":"string","maxLength":200},"effectiveOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"expiresAfter":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"generalLiability":{"type":"object","properties":{"eachOccurrence":{"type":"number","minimum":0},"aggregate":{"type":"number","minimum":0}},"additionalProperties":false},"workersCompensation":{"type":"object","properties":{"statutory":{"type":"boolean"},"employerLiability":{"type":"number","minimum":0}},"additionalProperties":false},"automobileLiability":{"type":"object","properties":{"combinedSingleLimit":{"type":"number","minimum":0}},"additionalProperties":false},"umbrellaLiability":{"type":"object","properties":{"eachOccurrence":{"type":"number","minimum":0},"aggregate":{"type":"number","minimum":0}},"additionalProperties":false},"additionalInsured":{"type":"boolean"},"waiverOfSubrogation":{"type":"boolean"}},"additionalProperties":false}},"required":["id","kind","name"],"additionalProperties":false}}},"required":["documents","requirements"],"additionalProperties":false},"example":{"asOf":"2026-11-02","documents":[{"id":"w9-1","type":"w9"}],"requirements":[{"id":"w9","kind":"document","name":"Form W-9","documentType":"w9"},{"id":"coi","kind":"document","name":"Certificate of insurance","documentType":"insurance_certificate"}]}}}},"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"},"asOf":{"type":"string"},"purpose":{"type":"string"},"projectName":{"type":"string"},"vendor":{"type":"object","properties":{"legalName":{"type":"string"},"normalizedName":{"type":"string"},"reference":{"type":"string"}},"additionalProperties":true},"assessment":{"type":"string"},"blocksWorkflow":{"type":"boolean"},"summary":{"type":"string"},"counts":{"type":"object","properties":{"satisfied":{"type":"number"},"missing_evidence":{"type":"number"},"expired":{"type":"number"},"failed":{"type":"number"},"not_verified":{"type":"number"}},"additionalProperties":true},"findings":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string"},"required":{"type":"boolean"},"status":{"type":"string"},"observed":{"type":"string"},"remediation":{"type":"string"},"source":{"type":"string"}},"additionalProperties":true}},"warnings":{"type":"array","items":{"type":"string"}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-02T19:00:00.000Z","asOf":"2026-11-02","purpose":"vendor-document-completeness","projectName":"Example project","vendor":{"legalName":"Example Construction LLC","normalizedName":"example construction","reference":"V-100"},"assessment":"requirements_unmet","blocksWorkflow":true,"summary":"One or more required items are missing, expired, or failed. Complete the remediation steps before continuing.","counts":{"satisfied":1,"missing_evidence":1,"expired":0,"failed":0,"not_verified":0},"findings":[{"id":"w9","name":"Form W-9","kind":"document","required":true,"status":"satisfied","observed":"w9-1","remediation":"No action is required for this item.","source":"Supplied document inventory"},{"id":"coi","name":"Certificate of insurance","kind":"document","required":true,"status":"missing_evidence","observed":"missing_evidence","remediation":"Add the missing insurance_certificate document to the package before continuing.","source":"Supplied document inventory"}],"warnings":["asOf was not supplied. The check used UTC date 2026-11-02."],"limitations":["Document completeness compares the supplied inventory with the buyer list and does not fetch the files."]}}}},"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.03"},"protocols":[{"x402":{}}]}}},"/api/v1/vendor-compliance/report":{"post":{"operationId":"build_a_vendor_compliance_report","summary":"Build a vendor compliance report","description":"Consolidate supplied vendor information, documents, attestations, evidence, and open items into one requirements report. External registries are not contacted.","tags":["vendor-compliance"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"asOf":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"projectName":{"type":"string","minLength":1,"maxLength":200},"vendor":{"type":"object","properties":{"legalName":{"type":"string","minLength":1,"maxLength":200},"reference":{"type":"string","minLength":1,"maxLength":80},"country":{"type":"string","minLength":2,"maxLength":80},"identifierPresent":{"type":"boolean"},"contactName":{"type":"string","minLength":1,"maxLength":200},"contactEmail":{"type":"string","minLength":3,"maxLength":200},"address":{"type":"string","minLength":1,"maxLength":300},"yearsInBusiness":{"type":"number","minimum":0,"maximum":200},"bondingCapacity":{"type":"number","minimum":0,"maximum":1000000000000},"safetyRecord":{"type":"string","minLength":1,"maxLength":500}},"required":["legalName"],"additionalProperties":false},"documents":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"type":{"type":"string","minLength":1,"maxLength":80},"title":{"type":"string","minLength":1,"maxLength":200},"issuedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"expiresOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"jurisdiction":{"type":"string","minLength":1,"maxLength":40},"licenseType":{"type":"string","minLength":1,"maxLength":120},"completedCeHours":{"type":"number","minimum":0,"maximum":1000},"certificateFields":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"value":{"type":"string","maxLength":200},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["name"],"additionalProperties":false}}},"required":["id","type"],"additionalProperties":false}},"requirements":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"kind":{"type":"string","enum":["field","document","insurance","licence","attestation","criterion"]},"name":{"type":"string","minLength":1,"maxLength":200},"required":{"type":"boolean"},"field":{"type":"string","minLength":1,"maxLength":40},"documentType":{"type":"string","minLength":1,"maxLength":80},"documentId":{"type":"string","minLength":1,"maxLength":80},"evidenceId":{"type":"string","minLength":1,"maxLength":80},"expiresAfter":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"jurisdiction":{"type":"string","minLength":1,"maxLength":40},"licenseType":{"type":"string","minLength":1,"maxLength":120},"minCeHours":{"type":"number","minimum":0,"maximum":1000},"minimum":{"type":"number"},"expected":{"type":"string","minLength":1,"maxLength":200},"insurance":{"type":"object","properties":{"namedInsured":{"type":"string","maxLength":200},"effectiveOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"expiresAfter":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"generalLiability":{"type":"object","properties":{"eachOccurrence":{"type":"number","minimum":0},"aggregate":{"type":"number","minimum":0}},"additionalProperties":false},"workersCompensation":{"type":"object","properties":{"statutory":{"type":"boolean"},"employerLiability":{"type":"number","minimum":0}},"additionalProperties":false},"automobileLiability":{"type":"object","properties":{"combinedSingleLimit":{"type":"number","minimum":0}},"additionalProperties":false},"umbrellaLiability":{"type":"object","properties":{"eachOccurrence":{"type":"number","minimum":0},"aggregate":{"type":"number","minimum":0}},"additionalProperties":false},"additionalInsured":{"type":"boolean"},"waiverOfSubrogation":{"type":"boolean"}},"additionalProperties":false}},"required":["id","kind","name"],"additionalProperties":false}},"attestations":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"statement":{"type":"string","minLength":1,"maxLength":500},"accepted":{"type":"boolean"},"acceptedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["id","statement","accepted"],"additionalProperties":false}},"evidence":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"value":{"type":"string","minLength":1,"maxLength":500}},"required":["id","value"],"additionalProperties":false}},"openItems":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"name":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["satisfied","missing_evidence","expired","failed","not_verified"]}},"required":["id","name","status"],"additionalProperties":false}}},"additionalProperties":false},"example":{"asOf":"2026-11-02","projectName":"Example project","vendor":{"legalName":"Example Construction LLC","country":"USA","identifierPresent":true},"documents":[{"id":"lic-1","type":"licence","jurisdiction":"US-TX","licenseType":"Journeyman Electrician","expiresOn":"2027-01-31","completedCeHours":4}],"requirements":[{"id":"licence","kind":"licence","name":"Texas journeyman electrician licence","jurisdiction":"US-TX","licenseType":"Journeyman Electrician"}]}}}},"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"},"asOf":{"type":"string"},"purpose":{"type":"string"},"projectName":{"type":"string"},"vendor":{"type":"object","properties":{"legalName":{"type":"string"},"normalizedName":{"type":"string"},"reference":{"type":"string"}},"additionalProperties":true},"assessment":{"type":"string"},"blocksWorkflow":{"type":"boolean"},"summary":{"type":"string"},"counts":{"type":"object","properties":{"satisfied":{"type":"number"},"missing_evidence":{"type":"number"},"expired":{"type":"number"},"failed":{"type":"number"},"not_verified":{"type":"number"}},"additionalProperties":true},"findings":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string"},"required":{"type":"boolean"},"status":{"type":"string"},"observed":{"type":"string"},"remediation":{"type":"string"},"source":{"type":"string"}},"additionalProperties":true}},"warnings":{"type":"array","items":{"type":"string"}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-02T19:00:00.000Z","asOf":"2026-11-02","purpose":"vendor-compliance-report","projectName":"Example project","vendor":{"legalName":"Example Construction LLC","normalizedName":"example construction","reference":"V-100"},"assessment":"requirements_met","blocksWorkflow":false,"summary":"Every required item in the supplied package met the buyer rules. This is not an approval to contract, pay, or close out.","counts":{"satisfied":1,"missing_evidence":0,"expired":0,"failed":0,"not_verified":0},"findings":[{"id":"licence","name":"Texas journeyman electrician licence","kind":"licence","required":true,"status":"satisfied","observed":"2027-01-31","remediation":"No action is required for this item.","source":"Stored US-TX Journeyman Electrician rule recorded 2026-10-28. The licence was not checked against the live registry."}],"warnings":["asOf was not supplied. The check used UTC date 2026-11-02."],"limitations":["The report consolidates the supplied vendor record, documents, attestations, evidence, and open items."]}}}},"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.08"},"protocols":[{"x402":{}}]}}},"/api/v1/vendor-compliance/contractor-closeout-check":{"post":{"operationId":"check_contractor_closeout","summary":"Check contractor closeout","description":"Compare buyer closeout requirements with supplied documents and attestations. A passing result does not certify that the project is complete.","tags":["vendor-compliance"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"asOf":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"projectName":{"type":"string","minLength":1,"maxLength":200},"vendor":{"type":"object","properties":{"legalName":{"type":"string","minLength":1,"maxLength":200},"reference":{"type":"string","minLength":1,"maxLength":80},"country":{"type":"string","minLength":2,"maxLength":80},"identifierPresent":{"type":"boolean"},"contactName":{"type":"string","minLength":1,"maxLength":200},"contactEmail":{"type":"string","minLength":3,"maxLength":200},"address":{"type":"string","minLength":1,"maxLength":300},"yearsInBusiness":{"type":"number","minimum":0,"maximum":200},"bondingCapacity":{"type":"number","minimum":0,"maximum":1000000000000},"safetyRecord":{"type":"string","minLength":1,"maxLength":500}},"required":["legalName"],"additionalProperties":false},"documents":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"type":{"type":"string","minLength":1,"maxLength":80},"title":{"type":"string","minLength":1,"maxLength":200},"issuedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"expiresOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"jurisdiction":{"type":"string","minLength":1,"maxLength":40},"licenseType":{"type":"string","minLength":1,"maxLength":120},"completedCeHours":{"type":"number","minimum":0,"maximum":1000},"certificateFields":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"value":{"type":"string","maxLength":200},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["name"],"additionalProperties":false}}},"required":["id","type"],"additionalProperties":false}},"requirements":{"minItems":1,"maxItems":40,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"kind":{"type":"string","enum":["field","document","insurance","licence","attestation","criterion"]},"name":{"type":"string","minLength":1,"maxLength":200},"required":{"type":"boolean"},"field":{"type":"string","minLength":1,"maxLength":40},"documentType":{"type":"string","minLength":1,"maxLength":80},"documentId":{"type":"string","minLength":1,"maxLength":80},"evidenceId":{"type":"string","minLength":1,"maxLength":80},"expiresAfter":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"jurisdiction":{"type":"string","minLength":1,"maxLength":40},"licenseType":{"type":"string","minLength":1,"maxLength":120},"minCeHours":{"type":"number","minimum":0,"maximum":1000},"minimum":{"type":"number"},"expected":{"type":"string","minLength":1,"maxLength":200},"insurance":{"type":"object","properties":{"namedInsured":{"type":"string","maxLength":200},"effectiveOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"expiresAfter":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"generalLiability":{"type":"object","properties":{"eachOccurrence":{"type":"number","minimum":0},"aggregate":{"type":"number","minimum":0}},"additionalProperties":false},"workersCompensation":{"type":"object","properties":{"statutory":{"type":"boolean"},"employerLiability":{"type":"number","minimum":0}},"additionalProperties":false},"automobileLiability":{"type":"object","properties":{"combinedSingleLimit":{"type":"number","minimum":0}},"additionalProperties":false},"umbrellaLiability":{"type":"object","properties":{"eachOccurrence":{"type":"number","minimum":0},"aggregate":{"type":"number","minimum":0}},"additionalProperties":false},"additionalInsured":{"type":"boolean"},"waiverOfSubrogation":{"type":"boolean"}},"additionalProperties":false}},"required":["id","kind","name"],"additionalProperties":false}},"attestations":{"maxItems":40,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"statement":{"type":"string","minLength":1,"maxLength":500},"accepted":{"type":"boolean"},"acceptedOn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["id","statement","accepted"],"additionalProperties":false}}},"required":["requirements"],"additionalProperties":false},"example":{"asOf":"2026-11-02","projectName":"Example project","documents":[{"id":"as-built-1","type":"as_built"}],"requirements":[{"id":"as-built","kind":"document","name":"As-built drawings","documentType":"as_built"},{"id":"punch","kind":"attestation","name":"Punch list","documentId":"punch"}],"attestations":[{"id":"punch","statement":"The punch list is closed.","accepted":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. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"asOf":{"type":"string"},"purpose":{"type":"string"},"projectName":{"type":"string"},"vendor":{"type":"object","properties":{"legalName":{"type":"string"},"normalizedName":{"type":"string"},"reference":{"type":"string"}},"additionalProperties":true},"assessment":{"type":"string"},"blocksWorkflow":{"type":"boolean"},"summary":{"type":"string"},"counts":{"type":"object","properties":{"satisfied":{"type":"number"},"missing_evidence":{"type":"number"},"expired":{"type":"number"},"failed":{"type":"number"},"not_verified":{"type":"number"}},"additionalProperties":true},"findings":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string"},"required":{"type":"boolean"},"status":{"type":"string"},"observed":{"type":"string"},"remediation":{"type":"string"},"source":{"type":"string"}},"additionalProperties":true}},"warnings":{"type":"array","items":{"type":"string"}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-02T19:00:00.000Z","asOf":"2026-11-02","purpose":"contractor-closeout-check","projectName":"Example project","vendor":{"legalName":"Example Construction LLC","normalizedName":"example construction","reference":"V-100"},"assessment":"requirements_unmet","blocksWorkflow":true,"summary":"One or more required items are missing, expired, or failed. Complete the remediation steps before continuing.","counts":{"satisfied":1,"missing_evidence":0,"expired":0,"failed":1,"not_verified":0},"findings":[{"id":"as-built","name":"As-built drawings","kind":"document","required":true,"status":"satisfied","observed":"as-built-1","remediation":"No action is required for this item.","source":"Supplied document inventory"},{"id":"punch","name":"Punch list","kind":"attestation","required":true,"status":"failed","observed":"The punch list is closed.","remediation":"Obtain acceptance of “The punch list is closed.” before continuing.","source":"Supplied attestation"}],"warnings":["asOf was not supplied. The check used UTC date 2026-11-02."],"limitations":["Closeout compares buyer closeout requirements with the supplied documents and attestations. It does not certify completion."]}}}},"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":{}}]}}}},"components":{"schemas":{"ApiError":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}