Create pre‑call verification links in one call

Simple REST + webhooks. Minimal data by design. Reporting included. Use verifd to verify callers before the ring, then grant a 24‑hour vPass.

Quickstart

Start a verification and share the returned link with the caller before dialing.

curl
curl -X POST https://api.verifd.ai/verify/start   -H 'X-API-Key: <YOUR_API_KEY>'   -H 'Content-Type: application/json'   -d '{
    "phoneNumber": "+15551234567",
    "name": "Acme Logistics",
    "reason": "Delivery confirmation",
    "scope": "24h",
    "consent": true
  }'
JavaScript
await fetch('https://api.verifd.ai/verify/start', {
  method: 'POST',
  headers: {
    'X-API-Key': '<YOUR_API_KEY>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    phoneNumber: '+15551234567',
    name: 'Acme Logistics',
    reason: 'Delivery confirmation',
    scope: '24h',
    consent: true
  })
});

Optional: you can also send Authorization: ApiKey <token> if your client already uses Authorization headers.

OpenAPI + Postman bundle

Download the spec or import it directly into Postman for a 5-minute setup.

Tip: In Postman, choose Import > Link and paste the OpenAPI URL.

Webhooks

Subscribe to events to track verification lifecycle and call outcomes.

Example payload
{
  "id": "evt_01HXXX",
  "type": "verification.verified",
  "data": {
    "verificationId": "ver_01HYYY",
    "phoneNumber": "+15551234567",
    "expiresAt": "2025-09-02T18:30:00Z"
  }
}
  • Retries: exponential backoff up to 24h; return 2xx to ack.
  • Security: sign with shared secret; verify signature on receipt.
  • Events: verification.started/verified/expired; pass.created/revoked.

Coming soon (enterprise and advanced)

Early access is rolling out. Contact us if you want these enabled.

  • SSO (SAML / OIDC) for enterprise access
  • Audit exports to your warehouse
  • Branded Verify with custom domains and theming
  • Tenant domain automation for DNS validation and provisioning
  • Privacy Pass + PIR live caller ID (privacy-preserving lookup)

OpenAPI & Support

Need the full spec or SDKs? Contact us and we'll share the OpenAPI file and examples tailored to your dialer or CRM.

  • Simple REST API for instant integration
  • Webhooks for real-time verification events
  • Admin reporting with success metrics
Contact supportSee how it works