{"uid":"cap_MonxSe60ILOzOBqzhZ5qK","slug":"halowerk-sms-receive-lease-425d319c","name":"Halowerk SMS Receive Lease","description":"Creates a five-minute inbound SMS lease through a configured licensed provider, polls received messages, and releases the number upstream on cancellation, expiry or failed x402 settlement. Twilio is supported directly; an HTTPS bearer-token lease provider can also implement the documented generic contract. Messages and lease metadata are removed after expiry.","url":"https://ident.halowerk.com/v1/sms-receive","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"mode":{"enum":["live","sandbox"],"type":"string","default":"live"},"action":{"enum":["lease","poll","cancel"],"type":"string"},"country":{"type":"string","default":"DE","pattern":"^[A-Z]{2}$"},"service":{"type":"string","maxLength":80,"minLength":2,"description":"Purpose label forwarded to the configured provider; never used to bypass provider restrictions."},"lease_id":{"type":"string","maxLength":80,"minLength":10},"sandbox_otp":{"type":"string","pattern":"^\\d{4,8}$","description":"Optional synthetic OTP returned only by a sandbox lease."},"terms_confirmed":{"type":"boolean","description":"Required for a live lease: confirms authorization and compliance with the third party and provider terms."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.006","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.006/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_HyS82ojQ8NY5i_zwEalGd","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Creates a temporary 5-minute inbound SMS number lease, polls for received messages, and releases the number on cancellation, expiry, or failed payment settlement.","exampleAgentPrompt":"I need to receive an SMS verification code right now — lease me a live German phone number for this purpose, I confirm I'm authorized and agree to the provider terms.","exampleUseCases":[{"title":"OTP receipt for account sign-up","prompt":"I'm registering for a new service that needs to verify a German phone number via SMS — lease me a live number, poll it until the OTP arrives, then cancel the lease."},{"title":"Sandbox SMS flow testing","prompt":"Run a test of the SMS receive flow in sandbox mode for Germany with a synthetic OTP of 123456 so I can verify my integration without using a real number."},{"title":"Automated identity verification pipeline","prompt":"My workflow needs a temporary inbound SMS number in DE to complete a live identity verification step — lease one now, I confirm authorization and compliance with all terms, and poll it for the incoming code."}],"resultDescription":"For a lease action: a lease_id, assigned phone number, country, and expiry timestamp. For a poll action: any SMS messages received on the leased number (sender, body, timestamp). For a cancel action: confirmation of release. Lease and message data are purged after expiry.","failureModes":["No phone numbers available in requested country — provider exhaustion error","Invalid or expired lease_id on poll/cancel — 404 or lease-not-found error","terms_confirmed not set to true for live lease — validation rejection","Failed x402 payment settlement — lease not created or released early","Sandbox OTP format mismatch — validation error","Provider (Twilio) connectivity failure — upstream error"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to programmatically receive an inbound SMS — such as capturing a one-time password or verification code — without a persistent phone number. It is ideal for ephemeral identity verification flows, automated account registration pipelines, or testing SMS-based auth in sandbox mode. Prefer it over full-featured SMS platforms when you only need a short-lived receive window and want pay-per-use x402 micropayment pricing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:40:09.608Z","isFirstParty":false}