{
 "schema_version": 1,
 "generated": "2026-10-26",
 "id": "sv-number-skills--get-verification-code-for-signup",
 "repo": "sv-number/skills",
 "repo_url": "https://github.com/sv-number/skills",
 "repo_slug": "sv-number-skills",
 "title": "Receive a signup SMS code on a number in a chosen country",
 "page_title": "How to receive a signup SMS code on a number in a chosen country with Skills",
 "summary": "An agent orders a number in the country a service expects, reads the code, and closes the activation.",
 "who": "A developer or agent operator whose automated signup is blocked by a 'we sent a code to your phone' step and who needs a number in a specific country.",
 "problem": "The agent has no phone number, and verification checks often reject numbers from the wrong country before any SMS is sent.",
 "outcome": "The agent holds a number in the requested country, receives the verification code through the API, and closes the activation so the charge stays or the money returns.",
 "steps": [
  "Run `curl -O https://raw.githubusercontent.com/sv-number/skills/main/sv-number/SKILL.md` to download the skill file.",
  "Run `export SVN_API_KEY=your_key_here` with your key from your SV Number profile.",
  "Run `python sv-number/scripts/order_number.py` or `node sv-number/scripts/order_number.mjs` after the skill is in place. (inferred, check the README)",
  "Let the script call getNumber, then poll getStatus every 3 to 5 seconds until it returns STATUS_OK with the code.",
  "Confirm the script calls setStatus 6 after the code is used, or setStatus 8 if nothing arrived."
 ],
 "agent_prompt": "Read the sv-number skill in the sv-number-skills repo and order a number for <service name> in <country>. Expected output: a phone number, the verification code, and a confirmation that the activation was closed with setStatus 6 or 8. Verify that the activation status is no longer waiting before you report success.",
 "agents": [
  "claude-code",
  "codex"
 ],
 "difficulty": "Intermediate",
 "time": "15 minutes",
 "basis": "readme",
 "caveat": "The README says these numbers are not for banking, payment or government accounts and do not send SMS or take calls, so use them only for receiving codes.",
 "category": "Software and DevOps",
 "tags": [
  "Software and DevOps"
 ],
 "lang": "python",
 "requirements": [
  "An SV Number account with a funded balance, since the README says there is no free tier",
  "An API key from your SV Number profile, exported as SVN_API_KEY",
  "curl and jq, plus Python or Node.js if you run the bundled scripts",
  "An agent runner that reads Agent Skills, such as Claude Code or Codex"
 ],
 "risk": "dual-use",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [
  {
   "tag": "credentials",
   "notice": "The SVN_API_KEY grants access to your balance, so keep it in the agent environment and do not paste it into prompts or logs."
  }
 ],
 "best": true,
 "score": 1.0,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/sv-number-skills/get-verification-code-for-signup/",
 "md": "https://dedupedai.com/use-cases/sv-number-skills/get-verification-code-for-signup/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/sv-number-skills--get-verification-code-for-signup.json",
 "api_version": "v1"
}