VendorVal
VendorVal is an API-first vendor verification and trust layer for procurement and compliance teams. It resolves entities from any identifier, checks SAM.gov registration status, verifies IRS TIN matching, and monitors vendors continuously — all through a single REST API.
Core concepts
Entity resolution
Before you can verify a vendor, VendorVal needs to identify them. Resolution takes any combination of identifiers you have — UEI, TIN, DUNS, CAGE code, legal name, or address — and returns a single canonical entity record with a confidence score.
Resolution is read-only. It never creates entities; it matches against VendorVal's canonical entity store, which is continuously synced from authoritative sources like SAM.gov.
Verification
Once you have an entity, you can run verifications against it:
- SAM.gov registration — Is this vendor currently registered and active in SAM.gov?
- IRS TIN matching — Does their EIN and legal name match IRS records?
Each check returns pass, fail, or error, with a confidence score, source attribution, and stored evidence.
Two verification modes
| Mode | Latency | Use when |
|---|---|---|
cached | 20–80ms | Nightly-synced data is acceptable |
realtime | 500ms–5s | You need guaranteed-current status |
Both modes return the same response schema.
Continuous monitoring
Subscribe to an entity for periodic re-verification. VendorVal will re-check the entity on your chosen schedule and send a webhook when anything changes.
Three primary endpoints
Most integrations use just three routes:
| Route | Purpose |
|---|---|
POST /v1/entities/lookup | Resolve an entity from identifiers — read-only, 90% of calls |
POST /v1/entities | Explicitly create an entity not in source registries |
POST /v1/verify | Lookup-or-create + verify in a single call |
Next steps
- Authentication — get your API key
- Quickstart — make your first API call in under 5 minutes