{"uid":"cap_GypnX6-KVb7ezCQwGTRSg","slug":"stablephone-050c3e13","name":"StablePhone: Buy a Phone Number","description":"Buy a phone number","url":"https://stablephone.dev/api/number","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"area_code":{"type":"string","pattern":"^\\d{3}$"},"country_code":{"enum":["US","CA"],"type":"string","default":"US"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"20","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$20/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"20","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"20","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_H6NEa3xxIXXYChvcgVE0q","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"20","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Purchase a dedicated phone number for use as an outbound caller ID for AI phone calls","exampleAgentPrompt":"Buy me a dedicated phone number on StablePhone so I can use it as a caller ID when making AI phone calls — charge it to my wallet.","exampleUseCases":[{"title":"Provision caller ID for agent","prompt":"Set up a dedicated phone number for my AI agent so it has a real caller ID when it reaches out to leads — charge my wallet and get it ready to make calls."},{"title":"Automate customer outreach calls","prompt":"I want to run automated outbound calls to my customer list using an AI agent. Get me a dedicated phone number on StablePhone so the calls show a consistent caller ID."},{"title":"Set up AI appointment reminder line","prompt":"My AI assistant needs to call patients with appointment reminders. Buy it a dedicated phone number on StablePhone so those calls show up with a real number instead of unknown."}],"resultDescription":"Returns a newly provisioned phone number tied to the paying wallet, usable as an outbound caller ID for AI phone calls. The number is valid for a set period (extendable via top-up) and associated with the purchasing wallet address.","failureModes":["Insufficient USDC balance — payment of $20.00 USDC fails","x402 payment protocol error — wallet or payment header malformed","No numbers available in the pool — service may be temporarily out of stock","Invalid wallet address — purchase cannot be attributed","Network or provider error — number provisioning fails on backend"],"whenToPreferThis":"Use this endpoint when an AI agent or user needs a persistent, dedicated phone number to act as a caller ID for outbound AI phone calls on StablePhone. This is the first step before making calls via the Call endpoint — a purchased number is required to appear as a real caller ID. Prefer this over generic VOIP number providers if you are already using StablePhone's AI call infrastructure.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:30:06.949Z","isFirstParty":false}