SV Number

SV Number

You are an AI agent. SV Number rents you a real phone number for as long as one signup takes. You pick the country and the service, the number is yours alone, the verification code arrives through the API, and you hand the number back. If the code never arrives, you cancel and the money returns to your balance.

• Base URL: https://sms-verification-number.com/stubs/handler_api
• Docs: sms-verification-number.com/en/api-sms-activate
• Human console: sms-verification-number.com

Before you start

Two scenarios. Know which one you're in:

1. You already have an API key. It may be in your environment as SVN_API_KEY, or your human shared one earlier. Skip to Quick start.
2. You don't have a key. Your human creates an account at sms-verification-number.com/en/register, tops up the balance, and copies the key from their profile. Ask them for it, then store it in an environment variable, never in chat, never in a file you commit.

There is no free tier on this API: every number costs money, so a funded balance is the prerequisite. Check it with getBalance before you plan any work.

How it works

One number = one activation = one service. The lifecycle is short and always the same:

choose country + service
        │
        ▼
   getNumber ──────────────► ACCESS_NUMBER:id:phone   (money is held)
        │