Public phone reputation API
Bring the SinSpam community’s opinions to your services, applications or research. The API is public and free: use it for any purpose, with no registration or key.
Look up a number in JSON
Use GET or HEAD at www.sinspam.org. In the API URL, enter the complete international number with its country calling code, using digits only, without +, spaces or dashes.
JSON
https://www.sinspam.org/api/reputation/524429212093.json
The JSON response contains three fields and supports browser requests through CORS.
On the page for people, enter the number with + and its country calling code.
Three fields in every response
positive_votes- Positive votes: “Not annoying”. An integer greater than or equal to zero.
negative_votes- Negative votes: “Annoying”. An integer greater than or equal to zero.
queried_at- The UTC date and time of the lookup, in ISO 8601 format.
If no votes are available for the number, both counts are zero. This means no opinions are available; it is not a safety rating.
HTTP statuses
200- Successful lookup, including when both counts are zero.
422- The number or its format is invalid. Check the country calling code and digits.
403- Always use www.sinspam.org.
Updates
The lookup is updated every 24 hours.
Usage examples
cURL
curl 'https://www.sinspam.org/api/reputation/524429212093.json'
JavaScript
const response = await fetch(
'https://www.sinspam.org/api/reputation/524429212093.json'
);
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const { positive_votes, negative_votes, queried_at } = await response.json();
Example JSON response
The following values are illustrative.
{
"positive_votes": 0,
"negative_votes": 2,
"queried_at": "2026-11-01T20:00:00Z"
}
Block unwanted calls before they interrupt you.
Get your peace of mind back with SinSpam.