{"uid":"cap__GqybrdJaW4RKIMksS29t","slug":"palmyr-communications-wait-for-otp-sms-verification-code-070b48ad","name":"Palmyr Communications – Wait for OTP/SMS Verification Code","description":"Wait (blocking, up to 90s) for an SMS verification code / OTP to arrive on a phone number you own, and return the parsed code. Body (all optional): { timeout_s (default 60, max 90), lookback_s (default 10; pass 0 for reused numbers), pattern (custom regex, max 256 chars) }","url":"https://palmyr.ai/phone/numbers/:id/wait-otp","method":"POST","headers":{},"bodySchema":{"properties":{"input":{"properties":{"body":{"type":"object","additionalProperties":true}}},"output":{"properties":{"example":{"type":"object","additionalProperties":true}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_CvJPrrExrxiRJXSVUR569","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Blocks up to 90 seconds waiting for an SMS OTP to arrive on a phone number you own, then returns the parsed verification code.","exampleAgentPrompt":"Wait up to 60 seconds for the OTP to arrive on phone number ID ph_abc123 — use a lookback of 0 seconds since it's a reused number — and return the verification code.","exampleUseCases":[{"title":"Automated account signup verification","prompt":"I just triggered a phone verification for the new account I'm creating — wait up to 90 seconds for the SMS OTP to arrive on phone number ID ph_xyz789 and give me the code so I can complete the signup."},{"title":"2FA login flow automation","prompt":"I've initiated a login that requires a 2FA code by SMS — block for up to 60 seconds waiting for it to land on phone number ID ph_def456 and return the one-time password so I can submit it."},{"title":"Disposable number OTP capture","prompt":"I'm using a freshly assigned disposable number with ID ph_ghi321 — set lookback to 0 since it may have prior messages, wait up to 90 seconds for the verification SMS to arrive, and extract the numeric code for me."}],"resultDescription":"Returns the parsed OTP/verification code extracted from the SMS that arrived on the specified phone number, along with metadata about the matched message.","failureModes":["Timeout: no OTP arrives within the specified timeout window (up to 90s), returning a timeout error","Pattern mismatch: an SMS arrives but no code matches the expected pattern","Invalid phone number ID: the specified number does not belong to the authenticated wallet","Invalid regex pattern: the custom pattern exceeds 256 characters or is malformed","Payment failure: the $0.02 USDC x402 payment is not completed or rejected"],"whenToPreferThis":"Use this endpoint when your agent needs to autonomously complete an SMS-based verification or 2FA flow on a phone number it controls, especially in automated signup, login, or account verification workflows where waiting for the OTP inline (up to 90s) is acceptable.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:43:10.973Z","isFirstParty":false}