sv-number

Order temporary phone numbers via API and receive SMS verification codes programmatically.

225|4|Updated Aug 7, 2026
One-click install
npx skills add https://github.com/sv-number/skills --skill sv-number-sv-number
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sv-number
Source: https://github.com/sv-number/skills/tree/main/sv-number
Command: npx skills add https://github.com/sv-number/skills --skill sv-number-sv-number

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) components.

What problem does it solve? AI agents and automated workflows hit a wall when a service demands phone verification during signup, login, or account recovery. This Skill rents a private phone number in any of 200+ countries through the sms-verification-number.com API, receives the SMS verification code programmatically, and releases the number when done. ## Core Features & Use Cases - On-demand number rental: Order a private number for a specific country and service, poll for the verification code, then finish or cancel the activation with automatic refunds when no code arrives. - Delivery-aware selection: Catalogue calls return per-service deliverability rates, live pool sizes, and cheapest-country lists so you pick country/service pairs that actually deliver. - Local TOTP second factor: Compute RFC 6238 authenticator codes locally from a stored secret, completing two-factor setups without third-party tools. - Use Case: Register a Telegram account on an Indonesian number: order the number, trigger the SMS, poll every 3-5 seconds for the code, and close the activation, all through curl or the included Python/Node scripts. ## Quick Start Set your SVN_API_KEY environment variable and ask the agent to order a number for a given service and country, then read back the verification code.

Frequently Asked Questions about sv-number

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I receive an SMS verification code through an API?

Call getNumber with a service and country to rent a number, trigger the SMS on the target site, then poll getStatus every 3 to 5 seconds until it returns STATUS_OK with the code. Finish with setStatus 6, or cancel with setStatus 8 for a refund.

How do I choose the best country for SMS verification?

Query getServicesAndCostWithStatistics for the target country and read the deliverability field, which shows the share of codes that arrived for other users. When deliverability is zero, fall back to quantity, since a large live pool indicates a pair other users succeed with.

Is there a free tier for the sms-verification-number API?

No, there is no free tier. Every number order holds money from your balance, so the account must be funded before calling getNumber. If no code arrives, cancelling or letting the activation expire returns the money automatically.

Why does getStatus keep returning STATUS_WAIT_CODE?

STATUS_WAIT_CODE means the SMS has not arrived yet; codes can take a couple of minutes. If nothing arrives, cancel with setStatus 8, noting that cancellation is refused with CANNOT_BEFORE_2_MIN during the first two minutes, so wait and retry.

Can I use one rented number for multiple services?

No, one activation equals one service. A number ordered for Telegram will not receive a Discord message, because each service code has its own number pool. Order a separate activation per service, or use the ot code only for sites absent from the catalogue.

How do I handle TOTP two-factor authentication after SMS verification?

Store the TOTP secret the service reveals and compute the six-digit code locally per RFC 6238 using the Python snippet in the Skill. Codes rotate every 30 seconds, so if one is rejected, check the machine clock and wait for the next window.