{"uid":"cap_s3hoI4cGeM5VrPlItsgoL","slug":"relayshield-phone-reputation-check-1814162e","name":"RelayShield Phone Reputation Check","description":"Check whether a phone number appears in criminal marketplace infrastructure or pivots to known scam wallets, kits, or actors, and whether its SIM was recently swapped (Twilio Lookup v2, cached 24h). Returns a high, medium, or unknown verdict with timestamped evidence reasons.","url":"https://api.relayshield.net/v1/payg/phone-reputation?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"phone":{"type":"string","description":"Phone number in E.164 format (e.g. +15551234567)"}}},"responseSchema":{"type":"json","example":{"ok":true,"data":{"note":"An absence of flags is not proof of safety.","level":"high","target":"+15551234567","flagged":true,"reasons":["seen in 3 criminal marketplace posts (most recent 2026-09-28)"],"signals":{"sim_swap":{"checked":true,"swapped":false},"line_type":{"checked":true,"line_type":"voip"},"attack_paths":[],"corpus_sightings":{"count":3,"most_recent":"2026-09-28T14:02:11+00:00"}}}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Q-RW4hdSaa8R0nVlyeTBP","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks whether a phone number appears in criminal marketplace infrastructure, scam wallets/kits, or known threat actors, and whether its SIM/eSIM was recently swapped, returning a high/medium/unknown verdict with timestamped evidence.","exampleAgentPrompt":"Before we respond to this unknown caller at +15551234567, can you check their phone reputation — specifically whether the number has shown up in any criminal marketplaces or scam activity, and whether their SIM was recently swapped?","exampleUseCases":[{"title":"Vet unknown smishing sender","prompt":"I just got a suspicious text from +14085559821 claiming to be my bank — can you check if that number has been flagged in any criminal marketplaces or scam databases, and whether it's a VoIP line?"},{"title":"Pre-call fraud screening for agent","prompt":"My AI agent is about to return a call to +12025557743 from an unrecognized number — run a reputation check first and tell me if there are any corpus sightings or SIM swap flags before it connects."},{"title":"Validate lead phone before outreach","prompt":"We're about to send an offer to a new lead whose number is +16175553390 — can you check RelayShield to see if that number has any criminal marketplace associations or suspicious signals before we reach out?"}],"resultDescription":"Returns a JSON object with: a top-level verdict level (high/medium/unknown), a flagged boolean, a list of human-readable reason strings with timestamps, and a signals object containing SIM swap status (checked, swapped), line type (mobile/voip/landline), corpus sightings count with most recent timestamp, and any known attack paths. Results are cached for 24 hours.","failureModes":["Invalid or non-E.164 phone number format returns a 400 error","Unknown numbers with no corpus data return level: unknown with flagged: false — absence of flags does not guarantee safety","Payment failure or insufficient USDC balance results in 402 Payment Required","Rate limiting may apply if the same number is queried before the 24h cache expires","Twilio Lookup v2 may be unavailable, causing SIM swap or line type signals to be unchecked"],"whenToPreferThis":"Use this endpoint when your agent needs to assess the trustworthiness of an inbound phone number or SMS sender before taking action, especially in financial, agentic, or high-trust workflows where social engineering via phone is a risk. Prefer this over generic OSINT lookups when you need both criminal marketplace corpus intelligence and telecom-level signals (SIM swap, line type) in a single call with a structured verdict.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T06:44:50.788Z","isFirstParty":false,"canonicalSlug":"relayshield-phone-reputation-check-1814162e"}