Skip to content

Phone spam check API with a 0 to 100 risk score

Send a US or Canadian number and get a spam risk score, a risk level and the complaint data behind them. The score is built from public FTC and FCC complaint records plus our own scoring. From 1 credit per lookup.

from 1 creditValidateCSV bulkMCP
POST/v1/phone-spam-check
{
  "success": true,
  "data": {
    "phone_number": "+15125550142",
    "risk_score": 82,
    "risk_level": "high",
    "complaints": {
      "ftc_reports_12m": 37,
      "fcc_reports_12m": 9,
      "last_reported": "2026-10-28"
    },
    "top_categories": [
      {
        "category": "robocall",
        "reports": 21
      },
      {
        "category": "debt",
        "reports": 11
      },
      {
        "category": "impersonation",
        "reports": 8
      }
    ],
    "line_type": "voip",
    "reasons": [
      "high_complaint_volume_12m",
      "reported_in_last_30_days",
      "voip_line"
    ]
  },
  "meta": {
    "credits_used": 1,
    "credits_remaining": 999,
    "cached": false,
    "request_id": "req_8f3a2c1e9b7d"
  }
}
[01/Response]

What you get back

The fields most teams branch on. The full response is in the sample on this page and in the API reference.

risk_scoreRisk scoreA number from 0 to 100. Higher means more complaint activity and more risk signals tied to the number.
risk_levelRisk levellow, medium or high. A banded version of the score for simple allow and block rules.
complaints.ftc_reports_12mFTC reportsComplaints consumers filed with the FTC about this number in the last 12 months.
complaints.fcc_reports_12mFCC reportsComplaints naming the number in FCC consumer complaint data over the same period.
complaints.last_reportedLast reportedDate of the newest complaint, which separates an old problem from a current one.
top_categoriesTop categoriesWhat callers were reported for, such as robocall, debt or impersonation, ordered by volume.
line_typeLine typemobile, landline, voip or toll_free, given as context for reading the score.
reasonsReasonsThe factors that moved the score, as short machine-readable codes.
[02/Capabilities]

What Phone Spam Check does

01

A score built on public complaint data

The score starts from complaints consumers filed with the FTC and the FCC, then applies our own scoring on top. The raw counts sit next to the score in the response, so you can see what it is based on.

02

Reasons you can show a reviewer

Each result lists the factors behind the score, for example a run of recent robocall reports or a VoIP line with complaints. Log them with the decision and your team can explain why a call was blocked.

03

Complaint categories, not only totals

Reports are grouped by what the caller was accused of: robocall, debt, impersonation and more. Twenty debt complaints and twenty impersonation complaints call for different responses.

04

Works on your own caller IDs too

Complaint data is keyed to the number that showed on caller ID. Run the numbers you dial from and you see which ones consumers have reported.

[03/Try it]

See the response before you sign up

Fill in the request and run it. The dashboard has the same form, plus history, bulk upload and live data.

POST /v1/phone-spam-checkfrom 1 credit

Preview mode: this page returns a sample response so you can see the shape of the data. Create a key to run it on live data.

Response

Fill in the field and run the lookup to see what comes back.

[04/Integrate]

One POST request

Send JSON with a Bearer key. The same key works for all 79 products.

curl -X POST https://api.1lookup.dev/v1/phone-spam-check \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone_number":"+15125550142"}'
Endpoint
POST /v1/phone-spam-check
Base URL
https://api.1lookup.dev
Request
phone_number
Price
from 1 credit
Coverage
US & Canada
Bulk
CSV upload and bulk API
Cache
Repeats within 7 days are free
Also via
Dashboard and MCP server (run_lookup)
[05/Use cases]

What teams use it for

Screen inbound callers

Look up the caller ID as a call arrives. Send low-risk numbers straight to an agent and route high-risk ones to voicemail or an IVR challenge.

Audit your outbound number pool

Score every number in your dialing pool on a schedule. Rest or retire the ones that are collecting complaints and review the campaign that used them.

Add a phone signal to fraud rules

Check the number a user gives at signup or checkout. A number with heavy impersonation complaints deserves a manual review before you ship an order or release a payout.

Vet numbers before you assign them

Recycled numbers carry their history with them. Score a new block before it goes to your sales team and hand back the numbers that arrive with complaints.

Complaint counts reflect what consumers reported, not verified findings. Caller ID can be spoofed, so a number with complaints may belong to someone who never placed the calls.

[06/Cost]

From 1 credit

Credits come with your plan and work on every product. Requests that fail on our side are never charged. Beyond your plan, extra credits are pay as you go.

See pricing
PlanPer 1,000 creditsPer 1,000 lookups
Starter $29/mo$4.83from $4.83
Growth $99/mo$3.96from $3.96
Pro $299/mo$3.32from $3.32
Scale $799/mo$2.66from $2.66
[07/FAQ]

Phone Spam Check questions

How is the spam score calculated?

It combines public complaint records from the FTC and the FCC with our own scoring, which weighs complaint volume, how recent the reports are, the categories involved and the line type. The counts and reasons are returned alongside the score.

Which numbers can I check?

Numbers in the US and Canada. The complaint records come from US agencies, so they reflect reports made by US consumers. Other countries are not supported.

What does a lookup cost?

Pricing starts at 1 credit per number. The credits used by each request are reported in meta.credits_used, and checking the same number again inside 7 days is free.

Does a low score mean the number is safe?

No. A low score means few or no complaints are on record and no other risk signal was found. New numbers and spoofed caller IDs can have a clean history, so treat the score as one input next to your own signals.

How is this different from Reported Number Check?

Reported Number Check returns the raw FTC complaint record for a number and nothing else. Phone Spam Check adds FCC data, line type context and a score with reasons, which is easier to use in an automated rule.

[ Validate ][ Enrich ]
[Get started]

Run Phone Spam Check on your own data

Starter is $29 a month for 6,000 credits, enough for up to 6,000 lookups a month.

[ Screen ][ Scrape ]