API Docs

Country-scoped ReverseVerify API

Verify your phone, subscribe to a country, then call the v1 endpoint with a bearer API key.

Verify Number View Countries

Quick start curl "https://reverseverify.org/api/v1/reverse-verify?country=US&phone=18322521999" \ -H "Authorization: Bearer rv_live_xxxxx"

1. Authenticate

Use your dashboard API key as a bearer token.

Authorization: Bearer YOUR_API_KEY

2. Choose country

Pass a country code. US is available now.

country=US

3. Send phone

Pass the phone number you want to check.

phone=18322521999

Endpoint

GET /api/v1/reverse-verify?country=US&phone=18322521999
Authorization: Bearer YOUR_API_KEY

JavaScript

const res = await fetch("https://reverseverify.org/api/v1/reverse-verify?country=US&phone=18322521999", {
  headers: { Authorization: "Bearer rv_live_xxxxx" }
});
console.log(await res.json());

Python

import requests

res = requests.get(
    "https://reverseverify.org/api/v1/reverse-verify",
    params={"country": "US", "phone": "18322521999"},
    headers={"Authorization": "Bearer rv_live_xxxxx"},
)
print(res.json())

Example response

{
  "ok": true,
  "country": "US",
  "reverse_verify_number": "18322521999",
  "phone": "18322521999",
  "status": "accepted",
  "message": "ReverseVerify country access is active. Provider lookup is not enabled yet."
}

Error codes

400 missing phone
401 missing or invalid API key
402 inactive country subscription
403 inactive user
404 country unavailable
429 quota exceeded