{"uid":"cap_uX-opqBCwwjewYlnfBbpm","slug":"api-phoneagent-xyz-74ebb4af","name":"PhoneAgent Countries Catalog","description":"PhoneAgent — countries with rentable SMS phone numbers for AI agents. Returns 190+ supported countries, each with the number of services offered and the cheapest price tier ($1, $2, or $5 USDC). Add ?service=<alias> (e.g. tg, wa, go, zo for OpenAI, other for any platform) to see which countries carry that service with live price and inventory pool. Companion route GET /services lists all 1,000+ service aliases; GET /services?country=<iso> lists what a single country offers. Pair with POST /rent","url":"https://api.phoneagent.xyz/countries","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"ISO 3166-1 alpha-2."},"name":{"type":"string"},"services":{"type":"integer","description":"Number of distinct services offered in this country."},"from_usdc":{"type":"number","description":"Cheapest SKU price available here (1, 2, or 5)."}}},"description":"Supported countries. Each entry carries the ISO code, name, count of services offered, and the cheapest SKU price available there. Add ?service=<code> to get the per-country price and inventory pool for one service. List services with GET /services (filter with ?country=<iso>)."}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"1.00","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-gsg-OYF-5vMISvEvxSoP","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a live catalog of 70+ countries with available rentable SMS phone numbers, per-service pricing, and inventory pool sizes for AI agent use","exampleAgentPrompt":"Show me which countries have phone numbers available for Telegram and WhatsApp verification, including pricing and how many numbers are in the pool — I want to pick a cheap option.","exampleUseCases":null,"resultDescription":"A structured list of 70+ countries, each with available services (Telegram, WhatsApp, Google, Facebook, Instagram, Twitter/X, Discord, Microsoft, Apple, PayPal, ChatGPT, other), pricing tier per service ($1, $2, or $5 USDC), and current inventory pool size. Data is refreshed every 5 minutes from upstream wholesale providers.","failureModes":["Network or upstream wholesale outage returns 5xx error — retry after a short delay","Empty or sparse inventory for a country/service combination due to pool depletion","Stale data window: catalog can be up to 5 minutes old, so just-depleted numbers may still appear available","POST body malformed or unexpected content-type may return 4xx"],"whenToPreferThis":"Use this endpoint when an AI agent needs to discover which countries and services have rentable SMS numbers available before committing to a rental. This is the discovery/catalog step that should precede any call to POST /rent. Prefer this when you need to compare pricing tiers, check inventory depth, or find the cheapest or most available country for a given service like Telegram or WhatsApp.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-08-11T18:17:21.324Z","lastSuccessfullyRanAt":"2026-08-11T18:17:21.324Z","lastHealthCheckAt":"2026-09-15T00:33:19.827Z","isFirstParty":false}