Agent Ready

Phone verification in one API call

Line type, carrier, and TCPA litigator check. Pay as you go. Built for AI agents, CRMs, and dialers.

Request
curl -X POST \
  https://us-central1-numberbroom-facea.cloudfunctions.net/api/v1/verify \
  -H "Authorization: Bearer nb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone": "+19025551234"}'
Request
import requests

resp = requests.post(
    "https://us-central1-numberbroom-facea.cloudfunctions.net/api/v1/verify",
    headers={"Authorization": "Bearer nb_live_YOUR_KEY"},
    json={"phone": "+19025551234"}
)
result = resp.json()
print(result["line_type"], result["is_litigator"])
Request
const resp = await fetch(
  "https://us-central1-numberbroom-facea.cloudfunctions.net/api/v1/verify",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer nb_live_YOUR_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ phone: "+19025551234" }),
  }
);
const data = await resp.json();
200 Response
{
  "phone":        "+19025551234",
  "line_type":    "mobile",
  "carrier":      "Verizon Wireless",
  "is_mobile":    true,
  "is_litigator": false,
  "status":       "verified",
  "cost":         0.044
}

Everything in one call

No stitching together three vendors. One endpoint, one price, one response.

Line Type Detection

Mobile, landline, VoIP, or unknown. Filter your list before you dial.

TCPA Litigator Flag

Known TCPA litigators are flagged so you can remove them before dialing.

Carrier Identification

Get the actual carrier name for each number. Know who you're calling through.

API Endpoints

Base URL: https://us-central1-numberbroom-facea.cloudfunctions.net/api

EndpointAuthDescription
GET /v1/health None Health check and version
POST /v1/keys Firebase ID Token Generate your API key (one-time display)
POST /v1/keys/revoke Firebase ID Token Revoke your active API key
GET /v1/balance API Key Check credit balance and remaining lookups
POST /v1/verify API Key Verify a single phone number
POST /v1/verify/batch API Key Verify up to 100 numbers in one request

Authentication

All API calls use a Bearer token in the Authorization header. For /v1/keys endpoints, pass your Firebase ID token. For all other endpoints, pass your API key:

Authorization: Bearer nb_live_a1b2c3d4e5f6...

Batch Verification

Send up to 100 numbers in a single request. Each valid number costs $0.044. Invalid numbers are skipped and not charged.

POST /v1/verify/batch
{
  "phones": ["+19025551234", "+12125559999", "+13105550000"]
}

Pricing

Pay as you go. No subscriptions, no monthly minimums, no surprises.

$0.044 per verification

Line type + carrier + TCPA litigator check. All included. Batch and single use the same price.

$25 credit

~568 verifications

$50 credit

~1,136 verifications

$100 credit

~2,272 verifications

$500 credit

~11,363 verifications

Quickstart

Three steps from zero to verified numbers.

1. Create an account

Sign up at numberbroom.com with email or Google. No credit card required to start.

2. Generate your API key

Call POST /v1/keys with your Firebase ID token. Store the key securely, it's shown once.

3. Start verifying

Add credits to your balance, then call POST /v1/verify with any phone number.

Ready to verify?

Get your API key in 30 seconds. First 10 verifications free for new accounts.

Get Started