Skip to content
Esc
↑↓navigate↵open⌘Jpreview

Check verification availability

GET/verifications/availability
Authorization
AuthorizationBearer token · headerrequired

A BillionSend API key (bs_…).

Responses
200

Whether the team may start deep verification, and its price

objectstringrequired
Allowed:verification_availability
paid_planbooleanrequired

Deep verification is open to paid plans; Free has the basic checks only

availablebooleanrequired

Whether deep verification can be started right now

price_per_1k_centsintegerrequired

What 1,000 verified addresses cost past the free credit, in cents

401

Missing, malformed, unknown or revoked API key

statusCodenumberrequired
namestringrequired
messagestringrequired
429

Over the rate limit (rate_limit_exceeded, with Retry-After)

statusCodenumberrequired
namestringrequired
messagestringrequired
Try it
Server
Authorization
Request
curl -X GET 'https://api.billionsend.com/verifications/availability' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'
Response
{
  "object": "verification_availability",
  "paid_plan": true,
  "available": true,
  "price_per_1k_cents": 0
}

Was this page helpful?