{"uid":"cap_kLxCCiMATDZx2mAOvvXT2","slug":"palmyr-communications-read-sms-messages-2efafdf6","name":"Palmyr Communications – Read SMS Messages","description":"Read all SMS messages received on a phone number you own or have shared access to.","url":"https://palmyr.ai/phone/numbers/:id/messages","method":"GET","headers":{},"bodySchema":{"properties":{"input":{"properties":{"queryParams":{"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_ey0rXVCPjVpLC4TP3sMQV","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":"Retrieves all SMS messages received on a phone number you own or have shared access to.","exampleAgentPrompt":"Show me all the SMS messages that have come in on my Palmyr phone number — the number ID is pn_abc123.","exampleUseCases":[{"title":"Audit virtual number SMS inbox","prompt":"Pull up every SMS that's been received on my virtual number pn_xyz789 — I need to review the full message history for a compliance audit."},{"title":"Archive incoming texts for records","prompt":"Fetch all the text messages that have come in on my Palmyr number pn_def456 so I can save them to our records system."},{"title":"Check recent texts on shared number","prompt":"Can you grab all the incoming SMS messages on the shared team number pn_ghi321? I want to see what customers have been sending us lately."}],"resultDescription":"A list of SMS messages received on the specified phone number, including message content, sender, and timestamp details for each message.","failureModes":["Phone number ID not found or does not exist (404)","Caller's payment wallet does not match the owning or authorized wallet for this number (403)","Phone number ID is malformed or missing (400)","Payment of $0.02 USDC not processed or insufficient funds (402)","No messages available yet on the number (empty list returned)"],"whenToPreferThis":"Use this endpoint when you need to list or review all SMS messages received on a specific phone number you own or have shared access to via Palmyr, especially for audit, archival, or manual review. For waiting on a specific OTP or verification code, prefer the blocking OTP-wait sibling endpoint instead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:48:41.657Z","isFirstParty":false}