{"uid":"cap_Qw1lMNgT6mCiVLKdcnLcJ","slug":"relayshield-sim-swap-detection-3642b0ee","name":"RelayShield SIM Swap Detection","description":"RelayShield Landing Site","url":"https://api.relayshield.net/v1/payg/sim-swap","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"phone":{"type":"string","description":"Phone number in E.164 format"}}},"responseSchema":{"type":"json","example":{"ok":true,"data":{"phone":"+14155551234","carrier":"T-Mobile","swapped":true,"checked_at":"2026-05-19T10:00:00+00:00","swap_timestamp":"2026-05-18T14:23:00Z"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","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.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_yZp6cIc84eq0yO6-EwYXx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks whether a given phone number has had a SIM swap performed recently, returning carrier and swap timestamp details","exampleAgentPrompt":"Before we process this login, can you check if +14155551234 has had a SIM swap recently — I want to make sure the phone number hasn't been hijacked.","exampleUseCases":[{"title":"Pre-authentication SIM fraud check","prompt":"Before sending the SMS verification code to +14155551234, check if that number has been SIM swapped in the last 24 hours — if it has, block the login attempt."},{"title":"Financial transaction safety gate","prompt":"We're about to wire $5,000 to an account tied to +12125550987 — can you run a SIM swap check on that number first to make sure it hasn't been recently ported or hijacked?"},{"title":"Account takeover investigation","prompt":"A customer is reporting suspicious activity on their account linked to +14085559876 — can you check whether their phone number experienced a SIM swap recently and tell me the carrier and when it happened?"}],"resultDescription":"Returns a JSON object with ok:true and a data object containing the phone number, current carrier name, a boolean indicating whether a swap occurred, the timestamp when the check was performed, and if swapped, the timestamp of the swap event.","failureModes":["Phone number not found or unsupported carrier returns error or null swap data","Invalid phone number format causes a 400-level error","Carrier data unavailable or rate-limited results in incomplete response","Network timeout or upstream carrier API failure returns non-ok response"],"whenToPreferThis":"Use this endpoint when you need to detect SIM swap fraud as part of an authentication or fraud-prevention pipeline, especially before sending OTP codes or approving high-value transactions. Prefer this over generic phone validation APIs when you specifically need SIM swap history and carrier attribution, not just number formatting or reachability checks.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:44:39.845Z","isFirstParty":false}