API Documentation

The Validator REST API is three endpoints — a phone check, an email check, and both in one call. Each is a base check plus the components you enable (carrier, ported status, DNC, live line, caller name, mailbox verification) — pay-per-use, billed to a prepaid wallet with no monthly commitment.

Integration guide

Auth, endpoints, request/response examples, error codes, billing overview.

Interactive explorer

Swagger UI — authorize with your API key and try live calls.

OpenAPI spec

Download /openapi.json for code generation or Postman import.

Authentication

All API requests require an Authorization: Bearer <api_key> header. Obtain your API key from the tenant portal.

curl -X POST https://getvalidator.io/v1/check/phone \
  -H "Authorization: Bearer vlt_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"phone": "+18134696697", "dncCheck": true}'

Missing or invalid keys return 401 Unauthorized. A wallet without enough credits returns 402 Payment Required (1 credit = $0.0005).

Endpoints

POST /v1/check/phone checks a phone number, POST /v1/check/email checks an email address, and POST /v1/check does both in one request. Send the identifier plus boolean component keys such as dncCheck or emailVerify; every endpoint returns the same envelope — { ok, phone, email, billing }. Full request and response shapes, the components table and error codes are in the integration guide. Live prices are public at GET /v1/pricing — no API key needed.

Method	Path	Description	Status
POST	`/v1/check/email`	Email check: free checks plus mailbox verification tiers	Live
POST	`/v1/check/phone`	Phone check: reference data plus the components you tick	Live
POST	`/v1/sessions`	Verification session management	Live
POST	`/v1/sessions/resend`	Resend email or SMS verification	Live

Services catalog

Each row maps to an Admin → Services billing rate. Use the selector column to choose which operation is billed.

Service	Operation	Price	Method	Path	How to select
Phone check	`check_phone`	2 credits ($0.0010)	POST	`/v1/check/phone`	— (send the identifier only)
Carrier check	`check_phone_carrier`	49 credits ($0.0245)	POST	`/v1/check/phone`	`carrierCheck: true`
Ported check	`check_phone_ported`	8 credits ($0.0040)	POST	`/v1/check/phone`	`portedCheck: true`
Email check	`check_email`	1 credit ($0.0005)	POST	`/v1/check/email`	— (send the identifier only)
Email verify	`check_email_verify`	20 credits ($0.0100)	POST	`/v1/check/email`	`emailVerify: true`
Email premium	`check_email_premium`	77 credits ($0.0385)	POST	`/v1/check/email`	`emailPremium: true`
DNC screening	`check_phone_dnc`	79 credits ($0.0395)	POST	`/v1/check/phone`	`dncCheck: true`
check_phone_dnc_overlay	`check_phone_dnc_overlay`	79 credits ($0.0395)	POST	`/v1/check/phone`	`dncCheck: true`
Live line	`check_phone_active`	28 credits ($0.0140)	POST	`/v1/check/phone`	`activeCheck: true`
Caller name (CNAM)	`check_phone_caller_name`	12 credits ($0.0060)	POST	`/v1/check/phone`	`callerName: true`
Phone premium	`check_phone_premium`	390 credits ($0.1950)	POST	`/v1/check/phone`	`phonePremium: true`
Session start	`session_start`	1 credit ($0.0005)	POST	`/v1/sessions`	— (send the identifier only)
Email resend	`email_send`	1 credit ($0.0005)	POST	`/v1/sessions/resend`	`channel=email`
SMS OTP	`sms_otp`	100 credits ($0.0500)	POST	`/v1/sessions/resend`	`channel=phone`

Read the integration guide

Detailed examples for every endpoint

Get your API key