Precheck vendor onboarding API
Compare a supplied vendor record, document list, and attestations with the buyer requirements. Missing, expired, failed, and unverified items are reported separately.
The Precheck vendor onboarding operation is part of the Vendor & Contractor Compliance API on BRAINIAC.software. Compare a supplied vendor record, document list, and attestations with the buyer requirements. Missing, expired, failed, and unverified items are reported separately. It is exposed as POST /api/v1/vendor-compliance/onboarding-precheck and priced at $0.04 USDC on Base. Payment uses the x402 exact scheme: an unpaid call returns HTTP 402 with payment requirements; after paying the exact USDC amount, retry the same request with a payment-signature header and Idempotency-Key. No account and no API key are required. Data sources for this product: The vendor record, document metadata, attestations, and evidence supplied in the request. Buyer-defined requirements supplied in the request. Stored licence rules already published for supported Texas TDLR and UK SIA types. Limitations: This product does not replace COI extraction, sanctions screening, prevailing wage, or licence renewal endpoints. Certificate files, sanctions lists, wage determinations, and licensing registries are not contacted. A stored licence rule is not a live licence verification. Missing evidence, expired documents, failed checks, and checks that could not be verified are separate statuses. requirements_met is not an approval to hire, pay, or close a contract. Outputs are compliance prechecks, drafts, or data lookups for human review. They are not official determinations, legal advice, identity confirmation, or certified filings. Related operations in this group include Prequalify a contractor, Check subcontractor payment readiness, Check vendor document completeness, Build a vendor compliance report. Open the group documentation for the full request schema, field notes, and response examples before integrating.
/api/v1/vendor-compliance/onboarding-precheckExample request
curl -i -X POST "https://www.brainiac.software/api/v1/vendor-compliance/onboarding-precheck" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"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"
}
]
}
JSONAn unpaid probe returns HTTP 402 with x402 payment requirements. After paying the exact USDC amount on Base, retry the identical request with a payment-signature header.
FAQ
- Do I need an API key? No. Pay the listed USDC amount with x402.
- What network? Base (eip155:8453), USDC.
- Is this an official determination? No. Results are for human review against the cited sources.
Related operations
- Prequalify a contractor — $0.05 USDC
- Check subcontractor payment readiness — $0.04 USDC
- Check vendor document completeness — $0.03 USDC
- Build a vendor compliance report — $0.08 USDC