How each product works

How to use Phone Spam Check

What Phone Spam Check takes in, which fields it returns and how credits are charged for each lookup.

Last updated 2026-10-22

What it does

Reported-caller complaints for a phone number from public FTC Do Not Call and FCC consumer complaint data: how many reports, when, and what kind of calls were reported. Complaints are unverified consumer reports, not a verdict about the caller.

What you send

Send these fields in the JSON body of the request.

Request fields for Phone Spam Check
Field	Type	Required	Limits
phone	string	Required	up to 64 characters

Request fields for Phone Spam Check

What you get back

The data object of a successful response carries these fields. Every response also lists its sources, the credits_charged and whether it was a cache_hit.

Each field is described in the API reference.

Response fields for Phone Spam Check
Field	Type
phone_e164	string
complaints_total	integer
first_reported	string
last_reported	string
issue_types	list
sources_used	list
spam_score	integer
risk_level	"none" or "low" or "medium" or "high"
score_basis	object
disclaimer	string

Response fields for Phone Spam Check

What it costs

1 credit per number with complaints on record.

What each outcome costs
Case	Charge
Found	1 credit
Nothing found	0 credits
Repeat inside 7 days	0 credits
Errors and invalid requests	0 credits

What each outcome costs

Run it

You can try it without an account in the free tool. The free tools share a limit per visitor.

From code, send a POST request to https://YOUR_API_HOST/v1/phone-spam with your API key.

1curl -X POST https://YOUR_API_HOST/v1/phone-spam \
2  -H "Authorization: Bearer $LOOKVALID_API_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{"phone":"+12025550143"}'

A request to Phone Spam Check

Full parameters and response fields are in the API reference. To run a list of values, use a bulk CSV job.

Good to know

A repeat of the same lookup within 7 days is served from your cache and costs 0 credits.
When the lookup finds nothing it returns found: false and costs 0 credits.
Invalid input and errors are never charged.
The API allows 200 requests per 10 seconds per key.

Still stuck? Write to hello@lookvalid.com.