curl -X GET "<base_url>/dpp/dwm/v2/breach/data/phone-numbers/{phone}" \
-H "X-AccessToken: YOUR_ACCESS_TOKEN"
{
"header": {
"message": "Success",
"response_code": 1
},
"body": {
"results": [
{
"username": "string",
"password": "string",
"firstName": "string",
"lastName": "string",
"city": "string",
"state": "string",
"postalCode": "string",
"phone": "string",
"email": "string",
"dob": "string",
"sourceId": 13080,
"documentId": "00000000-0000-0000-0000-000000000000",
"recordModificationDate": "2023-01-26T00:00:00Z",
"fullName": "string",
"emailDomain": "domain.com",
"emailUsername": "string",
"domain": "domain.com",
"passwordType": "plaintext",
"passwordPlaintext": "string",
"severity": 20,
"publishDate": "2017-11-04T00:00:00Z",
"source": {
"id": 13080,
"title": "Breach Name",
"shortTitle": "Breach Name",
"category": "exfiltrated",
"type": "PUBLIC",
"site": "domain.com",
"publishDate": "2017-11-04T00:41:18Z"
}
}
],
"page": 1,
"pageSize": 50,
"total": 1
}
}
Dark Web Scan
Get Records by Phone Number
Returns breach records in the dark-web breach dataset that expose the given phone number.
GET
/
dpp
/
dwm
/
v2
/
breach
/
data
/
phone-numbers
/
{phone}
curl -X GET "<base_url>/dpp/dwm/v2/breach/data/phone-numbers/{phone}" \
-H "X-AccessToken: YOUR_ACCESS_TOKEN"
{
"header": {
"message": "Success",
"response_code": 1
},
"body": {
"results": [
{
"username": "string",
"password": "string",
"firstName": "string",
"lastName": "string",
"city": "string",
"state": "string",
"postalCode": "string",
"phone": "string",
"email": "string",
"dob": "string",
"sourceId": 13080,
"documentId": "00000000-0000-0000-0000-000000000000",
"recordModificationDate": "2023-01-26T00:00:00Z",
"fullName": "string",
"emailDomain": "domain.com",
"emailUsername": "string",
"domain": "domain.com",
"passwordType": "plaintext",
"passwordPlaintext": "string",
"severity": 20,
"publishDate": "2017-11-04T00:00:00Z",
"source": {
"id": 13080,
"title": "Breach Name",
"shortTitle": "Breach Name",
"category": "exfiltrated",
"type": "PUBLIC",
"site": "domain.com",
"publishDate": "2017-11-04T00:41:18Z"
}
}
],
"page": 1,
"pageSize": 50,
"total": 1
}
}
Send a live request to
GET /dpp/dwm/v2/breach/data/phone-numbers/{phone} with Try it. See the full reference for the response fields and error codes: Get Records by Phone Number.
Path Parameters
string
required
Phone number, digits only (no spaces/dashes)
Query Parameters
number
Page number (1-based). 50 records/page over the newest 1000 stored (max 20 pages).
string
Registered user uuid — makes this a PAID lookup. Must belong to your partner (404 if not); a disabled or expired user gives 403. Omit for a free lookup.
curl -X GET "<base_url>/dpp/dwm/v2/breach/data/phone-numbers/{phone}" \
-H "X-AccessToken: YOUR_ACCESS_TOKEN"
{
"header": {
"message": "Success",
"response_code": 1
},
"body": {
"results": [
{
"username": "string",
"password": "string",
"firstName": "string",
"lastName": "string",
"city": "string",
"state": "string",
"postalCode": "string",
"phone": "string",
"email": "string",
"dob": "string",
"sourceId": 13080,
"documentId": "00000000-0000-0000-0000-000000000000",
"recordModificationDate": "2023-01-26T00:00:00Z",
"fullName": "string",
"emailDomain": "domain.com",
"emailUsername": "string",
"domain": "domain.com",
"passwordType": "plaintext",
"passwordPlaintext": "string",
"severity": 20,
"publishDate": "2017-11-04T00:00:00Z",
"source": {
"id": 13080,
"title": "Breach Name",
"shortTitle": "Breach Name",
"category": "exfiltrated",
"type": "PUBLIC",
"site": "domain.com",
"publishDate": "2017-11-04T00:41:18Z"
}
}
],
"page": 1,
"pageSize": 50,
"total": 1
}
}