API & integrations
Order verifications from your stack, not our dashboard.
REST API for ordering and polling, webhooks for decisions, and connectors for the procurement and KYB tools your team already runs.
Core endpoints
| Method | Path | Description |
|---|---|---|
| POST | /v1/verifications | Order a new verification. Returns id + tier + ETA. |
| GET | /v1/verifications/:id | Poll current status, confidence, and assigned reviewer. |
| GET | /v1/verifications/:id/report | Signed PDF + structured JSON dossier once decided. |
| POST | /v1/webhooks | Register a callback for status_changed and decision_issued events. |
| GET | /v1/coverage | List all 217 jurisdictions with current tier and median turnaround. |
Order a verification
POST /v1/verifications
Authorization: Bearer sk_live_...
Idempotency-Key: 4f9a2c8e-1b3d-4e7f-9a2b-8c1d3e5f7a9b
Content-Type: application/json
{
"supplier": "Meridian Components Sdn. Bhd.",
"country_code": "MY",
"registration_id": "1287654-K",
"package": "enhanced"
}
201 Created · 312 ms
{
"verification_id": "KBS-VR-2026-000184",
"status": "in_progress",
"country_tier": 2,
"estimated_sla": "PT6H",
"webhook_url": "https://your-app.example.com/webhooks/keybs",
"created_at": "2026-05-27T11:04:00Z"
}Webhook payload
POST https://your-app.example.com/webhooks/keybs
X-KeyBS-Signature: sha256=8f2c91...d340
X-KeyBS-Event: verification.completed
{
"verification_id": "KBS-VR-2026-000184",
"status": "completed",
"trust_score": 87,
"risk_band": "low",
"confidence": 0.92,
"country_tier": 2,
"registry_status": "active",
"sanctions_status": "clear",
"document_score": 0.94,
"beneficiary": "partial_match",
"analyst": "A. Okafor",
"recommendation": "proceed_with_controls",
"signed_at": "2026-05-27T17:08:00Z",
"report_url": "https://trust.keybs.io/profile/KBS-VR-2026-000184"
}Connectors
Prebuilt patterns and reference apps for the systems most KeyBS customers run.
Zapier
No-code trigger on decision_issued; push to Slack, Sheets, HubSpot, Salesforce.
n8n / Make
Self-hosted automation node for branching workflows on tier and confidence.
SAP Ariba & Coupa
Supplier-onboarding step that blocks PO creation until KeyBS confidence ≥ threshold.
Salesforce
Account-level enrichment with verified-by-KeyBS field and linked report URL.
Snowflake / BigQuery
Nightly export of every decision into your warehouse for audit.
Security & data handling
- TLS 1.3 in transit, AES-256 at rest. Reports signed with a published KeyBS public key.
- API keys scoped per environment; rotate from the admin console.
- Webhook payloads carry an HMAC-SHA256 signature header for verification.
- Customer-uploaded documents auto-purge 90 days after decision unless retention is contracted.