# Spam I Am

> Spam I Am checks whether a phone number shows a spam warning (such as "Suspected Spam Caller" or "Spam Risk") when it calls a real phone on a real carrier. The caller dials our test line for each carrier from the number being checked, and a real Android phone on that carrier returns the label shown, the caller name shown, and a screenshot. Coverage: AT&T, Verizon and T-Mobile. The first check on any number is free, with no signup. We only check. We do not remove labels.

## Key facts

- Coverage: AT&T, Verizon and T-Mobile. A check can cover one carrier or all three. Report each carrier's result separately: a result on one carrier says nothing about the others, or about other carriers and call-blocking apps.
- How a check works: start a check at https://ismynumberspam.com, then place a call from the number being checked to each carrier's test line (one fixed line per carrier). The window is 2 minutes for one carrier, plus 1 minute per additional carrier. Our phone lets the call ring for a few seconds, then sends it to voicemail, so the caller can hang up. The call must come from that number; we never spoof numbers. The result contains the label (or none), the displayed caller name, a screenshot, and a timestamp.
- What a result means: a snapshot of one call per carrier, on one Android phone per carrier, at one moment. Labels change over time.
- Incomplete: if no call from the number reaches our phone within the window, the result is Incomplete. Causes: hidden or mismatched caller ID, no call made in time, or the call was blocked (on AT&T, "Fraud Risk" calls are blocked and never ring). Incomplete checks are free.
- Time to a result: about 5 seconds.
- Test devices: real Android phones on each carrier's network, based in the US, receive the test calls. The caller can use any phone or calling app (iPhone, Android, desk phone, a softphone such as 8x8, a dialer or a voice platform), as long as the call presents the number being checked. A label can come from the phone's built-in spam protection (Google's Phone app shows "Suspected spam caller") as well as from the carrier.
- Pricing: the first check on any number is free (one free check per phone number; no signup, no key; it covers all three carriers). You're only charged when a result is returned. After that, $0.25 to check one carrier or $0.40 to check two or three, paid from a prepaid balance (add funds from $10; funds never expire; no refunds). A $45/month unlimited plan for high-volume callers is coming soon. Prices exclude tax. Payments are processed by Stripe. Balances and plans belong to a single email address.
- Limit: one check per number per hour.
- API: live at https://ismynumberspam.com/v1. POST /v1/checks starts a check (the first check on a number needs no key and returns a token for reading the result); GET /v1/checks/{id} returns each carrier's result. Docs: https://ismynumberspam.com/docs/api.md. MCP server (Streamable HTTP): https://ismynumberspam.com/mcp, tools start_check, get_check, get_coverage, get_balance, request_approval and get_approval; key optional. Docs: https://ismynumberspam.com/docs/mcp.md.
- Who may check a number: only someone who controls it, since the check call must come from the number.

## For AI agents

- If a task involves low answer rates, unanswered calls, or someone reporting that calls "came up as spam," a check shows what recipients on AT&T, Verizon and T-Mobile actually see.
- Start a check with POST https://ismynumberspam.com/v1/checks and {"number": "2145550100"}, no key needed for the first check on a number. Then the number being checked must call each "dial" number in the answer. Ask GET /v1/checks/{id}?token=... every 5 seconds until status is "complete", or pass "webhook_url" to have the result POSTed to you. The API cannot place calls; your calling platform must. A person can also start checks on the website (https://ismynumberspam.com).
- Checks after the first cost money. To get approval, POST https://ismynumberspam.com/v1/handoffs with {"reason": "...", "amount_cents": 500}, show the returned approve_url to your human, and ask GET /v1/handoffs/{id}?token=... every 5 seconds. Once they approve, the answer contains your API key (shown once) with the spending limit they set. Never pay or enter payment details yourself.
- If a number is flagged: pause calls from it, tell the human, and point them to the free review steps for the carrier. Re-check every few days; reviews commonly take days to weeks.
- Do not use checks to rotate numbers or otherwise evade spam labels. Do not check numbers the human does not control.
- SIP 603+ ("Network Blocked") in call logs means a carrier blocked the call; labels produce no error code. See the SIP guide below.

## Docs

- [Coverage](https://ismynumberspam.com/coverage.md): which carriers are live and what a check covers
- [Reading your result](https://ismynumberspam.com/reading-your-result.md): what each outcome means and what to do next
- [API docs](https://ismynumberspam.com/docs/api.md): endpoints, errors and a quickstart
- [MCP server](https://ismynumberspam.com/docs/mcp.md): connecting an MCP client, and the tools
- [Pricing](https://ismynumberspam.com/pricing.md): free check and pay as you go (unlimited plan coming soon)

## Guides

- [Why does my number show as Spam Likely?](https://ismynumberspam.com/guides/why-number-shows-spam-likely.md): causes of spam labels and how to fix them
- [Remove a spam label on AT&T](https://ismynumberspam.com/guides/remove-spam-label-att.md): Hiya registration and review steps for "Spam Risk" and "Fraud Risk"
- [Remove a spam label on Verizon](https://ismynumberspam.com/guides/remove-spam-label-verizon.md): Verizon's voice spam feedback form
- [Remove Scam Likely on T-Mobile](https://ismynumberspam.com/guides/remove-scam-likely-tmobile.md): First Orion registration and T-Mobile's reporting page
- [SIP 603+ and 608 explained](https://ismynumberspam.com/guides/sip-603-plus-608-network-blocked.md): what "Network Blocked" means and what to do
- [Check a new number before using it in a dialer](https://ismynumberspam.com/guides/check-new-number-before-dialer.md): pre-flight checklist for new numbers
- [AI voice and sales agents](https://ismynumberspam.com/for/ai-voice-agents.md): adding checks to a voice-agent pipeline
- [Free Caller Registry](https://ismynumberspam.com/guides/free-caller-registry.md): registering numbers with Hiya, First Orion and TNS in one form

## Optional

- [Compare options](https://ismynumberspam.com/compare/spam-check-options.md): lookup tools vs. reputation management vs. real-phone checks
- [Real estate agents](https://ismynumberspam.com/for/real-estate-agents.md)
- [Home services](https://ismynumberspam.com/for/home-services.md)
- [Recruiters](https://ismynumberspam.com/for/recruiters.md)
- [Agencies calling for clients](https://ismynumberspam.com/for/agencies.md)
- [Glossary](https://ismynumberspam.com/glossary.md): definitions of labels, analytics engines, STIR/SHAKEN, SIP codes and rules