Is Spam Detected ?
Device Checker

Is Spam Detected ?

We offer the following API call to determine if a phone is Spam Detected.

Is Spam Detected (Post) – You may validate that a phone is spam detected in one of our several ping services. If any ping service that you pass is determined to be spam, we will return Spam Detected in the response. Available spam services include YouMail, FCC complaint, FTC complaint, TrueSpam, NomoRobo, and RoboKiller.

End Point – https://api.callconfident.com/SpamCycle

Api Request

{
    "apiKey": "-------zOTgtZGEyOS00MDE1LTgzMjEtNjcwNDg1OGRiODk4",
    "phone": "6013630210",
    "pingTypes": "5|6|7|8|11|12",
    "sourceTypeId": "2"
}

apiKey – This can be found in your profile in your Call Confident account

phone – This is the 10-digit (US Phone, numbers only) phone number you are wanting to verify
pingTypes – These are the spam services you are wanting to check the phone against
  • FTC Complaint = 5
  • YouMail = 6
  • NomoRoboSpam = 7
  • RobokillerSpam = 8
  • FCC Complaint = 11
  • TrueSpam = 12
sourceTypeId – This is must be set to 2 which identifies this is an external API call

API Response

If any PingTypeValid = false, then the record is flagged by that spam service for being spam detected. We will return IsSpamDetected = true if any individual spam service is flagged. 
{
    "ApiCalledOn": "2024-01-08T06:39:13",
    "ApiCalledFromIp": "10.120.10.132",
    "ApiStatusCode": 1000,
    "ApiStatusMessage": "API Success",
    "Phone": "6013630210",
    "ApiRequestId": 293830,
    "IsSpamDetected": true,
    "DateTime": "2024-01-08T06:39:13.9433442-06:00",
    "ApiRequestPingList": [
        {
            "Id": 1657270,
            "CustomerApiRequestId": 293830,
            "PingTypeId": 5,
            "PingTypeValid": true,
            "PingTypeName": "FTC Complaint Check"
        },
        {
            "Id": 1657271,
            "CustomerApiRequestId": 293830,
            "PingTypeId": 11,
            "PingTypeValid": true,
            "PingTypeName": "FCC Complaint Check"
        },
        {
            "Id": 1657272,
            "CustomerApiRequestId": 293830,
            "PingTypeId": 8,
            "PingTypeValid": false,
            "PingTypeName": "Robokiller Spam Check"
        },
        {
            "Id": 1657273,
            "CustomerApiRequestId": 293830,
            "PingTypeId": 7,
            "PingTypeValid": true,
            "PingTypeName": "NomoRobo Spam Check"
        },
        {
            "Id": 1657274,
            "CustomerApiRequestId": 293830,
            "PingTypeId": 6,
            "PingTypeValid": true,
            "PingTypeName": "Youmail Spam Check"
        },
        {
            "Id": 1657275,
            "CustomerApiRequestId": 293830,
            "PingTypeId": 12,
            "PingTypeValid": true,
            "PingTypeName": "TrueSpam Check"
        }
    ]
}

Device Checker

We offer the following API call to determine if a phone number is shown as Spam Detected across multiple devices and multiple carriers. This will check to see if the submitted phone number shows as Spam Detected on both iPhone and Android devices. The carriers we currently check are T-Mobile, Cingular/ATT, Verizon and Cricket.

Device Checker (Post) – You may validate that a phone is showing spam detected using our device checker api. You will submit the initial post, and once our devices are checked, we will send back to your Web Hook URL. Make sure you have your Web Hook URL set up properly under Your Profile settings.

End Point – https://api.callconfident.com/DeviceChecker

Api Request

{
    "apiKey": "-------zOTgtZGEyOS00MDE1LTgzMjEtNjcwNDg1OGRiODk4",
    "phone": "6013630210",
    "pingTypes": "1",
    "sourceTypeId": "2"
}

apiKey – This can be found in your profile in your Call Confident account

phone – This is the 10-digit (US Phone, numbers only) phone number you are wanting to verify
pingTypes – These are the spam services you are wanting to check the phone against
  • DeviceChecker = 1
sourceTypeId – This is must be set to 2 which identifies this is an external API call

API Response

You will receive an immediate response back indicating that we received your request. Due to the timing elements involved in checking all devices and carriers, we will send back a final API response to the Web Hook URL listed under Your Profile settings.

{
    "ApiCalledOn": "2024-02-21T20:56:38",
    "ApiCalledFromIp": "192.168.1.4",
    "ApiStatusCode": 1000,
    "ApiStatusMessage": "API Success",
    "Phone": "6095211607",
    "ApiRequestId": 946605,
    "IsDeviceSpamDetected": "Wait For Webhook",
    "DateTime": "2024-02-21T20:56:38.496003+05:00",
    "ApiRequestPingDevice": [
        {
            "CustomerApiRequestId": 946605,
            "PingTypeId": 1,
            "PingTypeValid": "Wait For Webhook",
            "PingTypeName": "Device Spam Check by Carrier"
        }
    ]
}

Web Hook API Response

You must have Web Hook enabled with a valid URL that we will post results to.

*Only subscription plans can use the web hook feature 
{
    "Id": "28cb583e-ddcb-4692-9b1e-67dc9dc3eee8",
    "PhoneFrom": "7014145462",
    "VerizonAndroid": 2,
    "VerizonScreenAndroid": "https://storage.callconfident.com/callconfidentbucket/28cb583e-ddcb-4692-9b1e-67dc9dc3eee8-Verizon-droid.jpg",
    "VerizonIPhone": 2,
    "VerizonScreenIPhone": "https://storage.callconfident.com/callconfidentbucket/28cb583e-ddcb-4692-9b1e-67dc9dc3eee8-Verizon-iphone.jpg",
    "TestId": "48318",
    "TMobileAndroid": 2,
    "TMobileScreenAndroid": "https://storage.callconfident.com/callconfidentbucket/28cb583e-ddcb-4692-9b1e-67dc9dc3eee8-TMobile-droid.jpg",
    "TMobileIPhone": 2,
    "TMobileScreenIPhone": "https://storage.callconfident.com/callconfidentbucket/28cb583e-ddcb-4692-9b1e-67dc9dc3eee8-TMobile-iphone.jpg",
    "CingularAndroid": 3,
    "CingularScreenAndroid": "https://storage.callconfident.com/callconfidentbucket/28cb583e-ddcb-4692-9b1e-67dc9dc3eee8-Cingular-droid.jpg",
    "CingularIPhone": 3,
    "CingularScreenIPhone": "https://storage.callconfident.com/callconfidentbucket/28cb583e-ddcb-4692-9b1e-67dc9dc3eee8-Cingular-iphone.jpg",
    "CricketAndroid": 3,
    "CricketScreenAndroid": "https://storage.callconfident.com/callconfidentbucket/28cb583e-ddcb-4692-9b1e-67dc9dc3eee8-Cricket-droid.jpg",
    "CricketIPhone": 3,
    "CricketScreenIPhone": "https://storage.callconfident.com/callconfidentbucket/28cb583e-ddcb-4692-9b1e-67dc9dc3eee8-Cricket-iphone.jpg",
    "IsDeviceSpamDetected": true,
    "ApiRequestId": 961395,
    "Timestamp": "2024-02-23T08:02:08.8518424-06:00"
}

We will return results from each device (Android and iPhone) as well as the 4 carriers we check the phone number on (TMobile, Cingular, Verizon and Cricket). These results will include status and screenshot of each. Statuses are:

  • 2 – Clean Phone
  • 3 – Spam Detected
  • 4 – Carrier Blocked our calls
If any of the devices/carriers report back a status of 3, we set the IsDeviceSpamDetected = true.
Scroll to Top