{"uid":"cap_AF-VFVCRwqY7FglZn2ugp","slug":"sms-inbox-reader-physical-sim-19ba6aaf","name":"SMS Inbox Reader — Physical SIM","description":"Read the messages received by a phone number rented through /v1/sms/number: sender, body, and reception time, returned as structured data so an agent can extract a verification code without human help. The number is a physical SIM in a handset we operate, so it receives from senders that refuse virtual lines.","url":"https://api.x-402.online/v1/sms/inbox?utm_source=zero.xyz","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","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"otp":"483920","count":1,"phone":"+590690XXXXXX","messages":[{"body":"G-483920 is your code","sender":"Google"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_xdJ9eHg-gb_lHboXlQzoN","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns all messages received by a rented phone number, including sender, body, and reception timestamp, enabling an agent to extract verification codes autonomously.","exampleAgentPrompt":"Check the SMS inbox on my rented number and pull out any verification code or OTP that just came in — I need it to complete the signup flow.","exampleUseCases":[{"title":"Automated account signup OTP retrieval","prompt":"I just triggered a verification SMS to the number I rented — can you read the inbox and give me the 6-digit code that arrived?"},{"title":"Service registration with physical SIM requirement","prompt":"I'm registering on a site that rejects virtual numbers, so I rented a physical SIM number through your service — please check its inbox and extract the confirmation code they just sent."},{"title":"Polling for delayed verification text","prompt":"I signed up a few minutes ago and they said an SMS was coming — can you keep checking the inbox on my rented number and tell me the moment a verification message arrives?"}],"resultDescription":"A structured list of SMS messages received by the rented phone number, each containing the sender's number, the full message body (including any OTP or verification code), and the timestamp of reception. The agent can parse the body to extract codes without human involvement.","failureModes":["No messages in inbox yet — returns empty list if no SMS has arrived","Number not rented or expired — returns an error if the number is no longer active","Payment failure — 402 response if USDC payment is not settled","Rate limiting — too many polls in a short window may be throttled","SMS delivery delay — message may not have arrived yet at poll time"],"whenToPreferThis":"Use this endpoint when your agent needs to autonomously retrieve a verification code or OTP sent via SMS to a rented physical SIM number — especially when the target service rejects virtual or VoIP numbers. This is preferable to any virtual number service when dealing with strict carrier filtering.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-09T18:43:09.308Z","isFirstParty":false,"canonicalSlug":"sms-inbox-reader-physical-sim-19ba6aaf"}