{"uid":"cap_d9fmwMxqgwQB5r57t5T3Z","slug":"codepulse-api-temporary-sms-number-lookup-06f4d1d1","name":"CodePulse API – Temporary SMS Number Lookup","description":"Lists active public numbers available for temporary SMS verification codes.","url":"https://codepulse-api.hahavoid0.workers.dev/phone/temp-sms","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"result":{"numbers":[{"number":"+19142880099","country":"United States","provider":"receivesms"}]},"warnings":[],"supported":true,"confidence":"high","data_as_of":"2026-06","disclaimer":"Informational support only. Not legal, tax, medical, veterinary, or financial advice. Verify with the cited official source or a qualified professional before acting."}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.15","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":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9irxGgM7r780G3lu--rfA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a list of available disposable/temporary phone numbers that can receive SMS, along with their country and provider details.","exampleAgentPrompt":"I need a temporary phone number that can receive SMS messages — something disposable so I don't have to use my real number. Can you grab one for me right now?","exampleUseCases":[{"title":"Bypass real number for app signup","prompt":"I'm signing up for a new app and they want my phone number for verification — can you get me a temporary SMS number I can use instead of my real one?"},{"title":"Anonymous SMS verification for testing","prompt":"I'm testing my app's SMS verification flow and need a real-looking disposable phone number in the US that can receive texts — what's available right now?"},{"title":"One-time code without exposing personal number","prompt":"I need to receive a one-time verification code from a website but I don't want to give them my actual phone number — can you find me a temp number I can use?"}],"resultDescription":"Returns a JSON object with an array of available temporary phone numbers, each including the full number (e.g. +19142880099), the country, and the underlying provider (e.g. receivesms). Also includes a confidence level (high/medium/low), data freshness date, whether temp SMS is supported, any warnings, and a standard informational disclaimer.","failureModes":["No temporary numbers currently available — empty numbers array returned","Service temporarily unavailable due to upstream provider outage","Invalid or malformed POST body returns validation error","Provider list may be stale if data_as_of date is old","Network timeout from the Cloudflare Worker backend"],"whenToPreferThis":"Use this endpoint when an agent or user needs a quick, no-signup disposable phone number to receive SMS, particularly for one-time verifications or testing. Prefer this over manual lookup of temp SMS sites when you need a structured, machine-readable result. It costs $0.15 USDC per call via x402 on Base, so it is best suited for on-demand single lookups rather than bulk number harvesting.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-08-11T19:33:57.657Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:49:22.724Z","isFirstParty":false}