API reference
Every operation in the Verdict API, generated from openapi.json (OpenAPI 3.1.0, API version 2026-11-01). Each page shows an example request as curl, an example response, the price and the scope. The interactive reference renders the same document with Scalar.
Decisions
Section titled “Decisions”The six priced decisions and decision lookup.
| Call | What it does | Price |
|---|---|---|
POST /v1/decisions/qualify_firm |
Is this firm in my ICP? | $0.005 per call, billed only when an answer is returned |
POST /v1/decisions/score_signal |
Does this event matter, and is now the time? | $0.005 per call, billed only when an answer is returned |
POST /v1/decisions/pick_person |
Who at this firm should I write to? | $0.005 per call, billed only when an answer is returned |
POST /v1/decisions/triage_reply |
What does this reply mean? | $0.003 per call, billed only when an answer is returned |
POST /v1/decisions/right_person |
Is this the right person to contact? | $0.003 per call, billed only when an answer is returned |
POST /v1/decisions/should_send |
Should this message go out now? | $0.003 per call, billed only when an answer is returned |
GET /v1/decisions/{id} |
Get a decision | free |
Firms, events and sources from Verdict’s open-licensed index.
| Call | What it does | Price |
|---|---|---|
GET /v1/firms/resolve |
Resolve a firm reference | free |
GET /v1/firms/{id} |
Get a firm | free |
GET /v1/events |
List events | free unscored; with icp_id each scored event bills one score_signal ($0.005) |
GET /v1/sources |
List index sources | free |
Watches
Section titled “Watches”Standing scored-event subscriptions delivered by webhook.
| Call | What it does | Price |
|---|---|---|
GET /v1/watches |
List watches | free |
POST /v1/watches |
Create a watch | free to create; each delivered event bills one score_signal ($0.005) |
GET /v1/watches/{id} |
Get a watch | free |
DELETE /v1/watches/{id} |
Delete a watch | free |
GET /v1/watches/{id}/deliveries |
List a watch’s deliveries | free |
POST <your webhook_url> (scoredEvent) |
A scored event for a watch | bills one score_signal ($0.005) when delivered, never per retry |
POST <your webhook_url> (watchChallenge) |
Verify a new webhook URL | free |
Outcomes
Section titled “Outcomes”What happened after a decision; feeds calibration.
| Call | What it does | Price |
|---|---|---|
POST /v1/outcomes |
Report an outcome | free |
Inbound webhooks
Section titled “Inbound webhooks”Receivers that turn vendor webhooks into outcomes.
| Call | What it does | Price |
|---|---|---|
POST /v1/webhooks/instantly/{receiver_token} |
Receive Instantly webhooks | free |
POST /v1/webhooks/smartlead/{receiver_token} |
Receive Smartlead webhooks | free |
POST /v1/webhooks/calcom/{receiver_token} |
Receive Cal.com webhooks | free |
POST /v1/webhooks/calendly/{receiver_token} |
Receive Calendly webhooks | free |
POST /v1/webhooks/stripe |
Receive Stripe webhooks | free |
ICP profiles
Section titled “ICP profiles”Who you sell to and the thresholds decisions apply.
| Call | What it does | Price |
|---|---|---|
GET /v1/icps |
List ICP profiles | free |
POST /v1/icps |
Create an ICP profile | free |
GET /v1/icps/{id} |
Get an ICP profile | free |
PATCH /v1/icps/{id} |
Update an ICP profile | free |
PATCH /v1/icps/{id}/thresholds |
Set decision thresholds | free |
Account
Section titled “Account”Sign-up, identity, keys, limits and the audit log.
| Call | What it does | Price |
|---|---|---|
POST /v1/signup |
Sign up | free |
POST /v1/signup/verify |
Verify sign-up and get a key | free |
GET /v1/me |
Who am I | free |
GET /v1/keys |
List API keys | free |
POST /v1/keys |
Create an API key | free |
PATCH /v1/keys/{id} |
Change an API key | free |
DELETE /v1/keys/{id} |
Revoke an API key | free |
POST /v1/keys/{id}/rotate |
Rotate an API key | free |
GET /v1/limits |
Get limits | free |
GET /v1/audit |
List audit log entries | free |
Billing
Section titled “Billing”Balance, top-ups, usage and the ledger.
| Call | What it does | Price |
|---|---|---|
GET /v1/balance |
Get the balance | free |
POST /v1/topup |
Buy a credit pack | free |
GET /v1/usage |
Get usage | free |
GET /v1/ledger |
List ledger entries | free |
Console
Section titled “Console”Console sign-in, sessions, TOTP and members (cookie auth).
| Call | What it does | Price |
|---|---|---|
POST /v1/console/magic-link |
Email a console sign-in link | free |
POST /v1/console/magic-link/consume |
Sign in with a magic link | free |
POST /v1/console/oauth/github/start |
Start GitHub sign-in | free |
POST /v1/console/oauth/github/callback |
Finish GitHub sign-in | free |
GET /v1/console/session |
Get the console session | free |
DELETE /v1/console/session |
Sign out | free |
POST /v1/console/totp/enrol |
Start TOTP enrolment | free |
POST /v1/console/totp/verify |
Verify a TOTP code | free |
POST /v1/console/totp/disable |
Turn TOTP off | free |
GET /v1/console/orgs |
List my organizations | free |
GET /v1/console/orgs/{org_id}/members |
List members | free |
POST /v1/console/orgs/{org_id}/invites |
Invite a member | free |
PATCH /v1/console/orgs/{org_id}/members/{user_id} |
Change a member’s role | free |
DELETE /v1/console/orgs/{org_id}/members/{user_id} |
Remove a member | free |
GET /v1/console/orgs/{org_id}/audit |
List audit log entries (console) | free |
Schemas
Section titled “Schemas”Every request and response schema, with its fields, is on Schemas.