Skip to main content
POST
Submit One-Time Scan
Submit a batch of phone numbers for one-time carrier spam score scanning. Results are delivered asynchronously via webhook notification.
Unlike TrustCall monitoring, one-time scans do not add numbers to ongoing monitoring. Results are delivered to your webhook URL when the scan completes.

Request

Headers

string
required
Your API Key (LoginId from your DNCScrub account)
string
required
Must be application/json

Request Body

string[]
required
Array of 10-digit phone number strings to scan
string
required
Webhook URL where scan results will be POSTed when complete. Maximum 1500 characters.
Consider using webhook.site to generate a temporary URL for testing. It lets you inspect the exact payload and headers sent by the callback, making it easy to understand the webhook structure before implementing your production endpoint.
string
Optional API key to include in the webhook notification header. Maximum 1500 characters.
string
required
Type of scan to perform: - carrier - Carrier scores only (Verizon, AT&T, T-Mobile) - carrierandapps - Carrier scores plus app scores (RoboKiller, Nomorobo, FTC complaints)
boolean
Set to true to test your webhook URL without performing an actual scan. The system will send a test payload to verify your endpoint is reachable.

Example Request

Response Fields

string (UUID)
Unique identifier for the scan job. Use this to check scan status.
string
Initial status of the scan: Submitted
integer
Number of phone numbers submitted for scanning

Webhook Notification

When the scan completes, results are POSTed to your NotificationURL:

Error Responses

Scan Types