For developers

SMS verification API

Buy real non-VoIP numbers and receive verification codes from your own code, or let an AI agent do it through our MCP server.

Read the API docsGet an API key

  • REST API

    JSON over HTTPS with a Bearer API key. Buy numbers, read messages, and reuse, renew or flag numbers from your own code.

  • Webhooks

    Get a POST the moment an SMS arrives, plus events when a number is purchased, flagged, reused or renewed.

  • MCP server

    Let AI agents in Claude Code, Cursor, VS Code, Codex, Windsurf or Cline manage numbers through 11 tools.

  • Short- and long-term numbers

    20-minute numbers for one-off codes, 3- to 30-day rentals you can renew, and All Services plans.

  • Six countries

    US and UK numbers for specific services; Canada, Hong Kong, Indonesia and Australia on All Services plans.

  • Postman collection

    Import the ready-made collection and make your first authenticated call in minutes.

    Download the collection

Quick start

From sign-up to your first verification code in four steps.

  1. Create an API key

    Sign up for free, open Settings → API keys and create a key. Send it in the Authorization header with every request.

    Authorization: Bearer API-xxxxx...

  2. Find the service you need

    List every service you can order, with its ID, country and price.

    curl -X GET "https://prod-v3.pvadeals.com/v3/api/services/all" \
  -H "Authorization: Bearer API-xxxxx..."

  3. Buy a number

    Pass the service ID to purchase a short-term number. The cost comes from your credit balance.

    curl -X POST "https://prod-v3.pvadeals.com/v3/api/purchase" \
  -H "Authorization: Bearer API-xxxxx..." \
  -H "Content-Type: application/json" \
  -d '{"services": [{"serviceId": "697139f7fe5460ddc2f27214"}]}'

  4. Receive the code

    Set a webhook URL in the dashboard or with POST /v3/api/webhook, and we send each SMS to you as it arrives.

    {
  "event": "sms_received",
  "timestamp": "2026-01-28T22:57:35.001Z",
  "requestId": "697a90d25ef1873ef44f48bc",
  "serviceId": "697139f7fe5460ddc2f27214",
  "number": "+13130001234",
  "message": "Your Airbnb verification code is 2200."
}

See every endpoint in the API reference

Give your AI agent a phone number

Connect any MCP client to our server with your API key, and your agent can check your balance, find a service, buy a number and read the code, all from a chat.

https://prod-v3.pvadeals.com/mcp
Authorization: Bearer API-YOUR_KEY_HERE

Try: Buy one number for this service. Ask me before purchasing.

Set up the MCP server
  • get_balanceCheck your credit balance
  • list_servicesList available services
  • get_serviceGet one service by ID
  • purchase_numberBuy a short-term number
  • purchase_ltr_numberBuy a long-term or All Services number
  • check_smsRead the messages and codes on a number
  • list_active_numbersList your active numbers
  • flag_numberFlag a number for review
  • get_webhookShow your webhook settings
  • set_webhook_urlSet or change your webhook URL
  • clear_webhookRemove your webhook URL

Rate limits

Two layers of limits keep the platform fast for everyone. A 429 response tells you when to retry.

All /v3/api/* requests, per IP
300 requests per 60 seconds
Purchases, per IP
60 requests per 60 seconds
Each endpoint, per API key
Its own cap, for example 10 per minute for /services/all

Frequently asked questions

How do I get an API key?

Create a free PVADeals account, open Settings → API keys and create a key. Keep it private: anyone with the key can spend your credits.

How are API purchases paid for?

Numbers you buy through the API or the MCP server are paid from your PVADeals credit balance, the same way as purchases in the dashboard.

Which countries can I order through the API?

US and UK numbers for specific services, and Canada, Hong Kong, Indonesia and Australia through All Services long-term rentals.

Can an AI agent buy numbers by itself?

Yes. The MCP server’s purchase tools spend your credits, so tell your agent to ask you before it buys, as our example prompts do.

Ready for your first number?

Creating an account is free. Add credits from $3 and start receiving SMS codes.

Create accountLog in