curl -X POST "<base_url>/dpp/dbos/v2/id-enrichment-by-phone" \
-H "X-AccessToken: YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"phone": "string"
}'
{
"header": {
"message": "Success",
"response_code": 1
},
"body": {
"phone": "string",
"formattedPhone": "string",
"found": true,
"resultCount": 1,
"foundData": [
{
"fullName": "string",
"firstName": "string",
"middleName": "string",
"lastName": "string",
"address": "string",
"city": "string",
"state": "string",
"county": "string",
"zip": "string",
"carrier": "Verizon Wireless",
"phoneType": "landline",
"areaCode": "202",
"areaName": "Washington",
"timezone": "America/New_York",
"coordinates": {
"lat": 0.0,
"lng": 0.0
},
"countryCode": "US"
}
]
}
}
ID Enrichment
Reverse Phone Lookup
Reverse phone lookup for US numbers: the registered owner’s name, address, carrier and phone-type classification when available.
POST
/
dpp
/
dbos
/
v2
/
id-enrichment-by-phone
curl -X POST "<base_url>/dpp/dbos/v2/id-enrichment-by-phone" \
-H "X-AccessToken: YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"phone": "string"
}'
{
"header": {
"message": "Success",
"response_code": 1
},
"body": {
"phone": "string",
"formattedPhone": "string",
"found": true,
"resultCount": 1,
"foundData": [
{
"fullName": "string",
"firstName": "string",
"middleName": "string",
"lastName": "string",
"address": "string",
"city": "string",
"state": "string",
"county": "string",
"zip": "string",
"carrier": "Verizon Wireless",
"phoneType": "landline",
"areaCode": "202",
"areaName": "Washington",
"timezone": "America/New_York",
"coordinates": {
"lat": 0.0,
"lng": 0.0
},
"countryCode": "US"
}
]
}
}
Reverse phone lookup for US numbers: the registered owner’s name, address, carrier and phone-type classification when available. Only US (+1) numbers are supported. The body shape is always the same; inspect body.found to tell a resolved number from one with no record. To look a person up by name and location, use POST /dpp/dbos/v2/id-enrichment-by-name-location.
See Errors for the response envelope and the full list of codes.
- URL:
/dpp/dbos/v2/id-enrichment-by-phone - Full URL:
<base_url>/dpp/dbos/v2/id-enrichment-by-phone - Request Method: POST
Authentication
Send the Access Token in theX-AccessToken request header on every authenticated call:
X-AccessToken: YOUR_ACCESS_TOKEN
Request Body
string
required
10-digit US NSN, or 11 digits starting with 1. Non-digits are ignored.
Sample Request
cURL
curl -X POST "<base_url>/dpp/dbos/v2/id-enrichment-by-phone" \
-H "X-AccessToken: YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"phone": "string"
}'
curl -X POST "<base_url>/dpp/dbos/v2/id-enrichment-by-phone" \
-H "X-AccessToken: YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"phone": "string"
}'
Response
object
object
Show body
Show body
string
10-digit NSN (no country code, no formatting).
string
boolean
number
string
Present only when found is false.
Sample Response
Success
{
"header": {
"message": "Success",
"response_code": 1
},
"body": {
"phone": "string",
"formattedPhone": "string",
"found": true,
"resultCount": 1,
"foundData": [
{
"fullName": "string",
"firstName": "string",
"middleName": "string",
"lastName": "string",
"address": "string",
"city": "string",
"state": "string",
"county": "string",
"zip": "string",
"carrier": "Verizon Wireless",
"phoneType": "landline",
"areaCode": "202",
"areaName": "Washington",
"timezone": "America/New_York",
"coordinates": {
"lat": 0.0,
"lng": 0.0
},
"countryCode": "US"
}
]
}
}
{
"header": {
"message": "Success",
"response_code": 1
},
"body": {
"phone": "string",
"formattedPhone": "string",
"found": true,
"resultCount": 1,
"foundData": [
{
"fullName": "string",
"firstName": "string",
"middleName": "string",
"lastName": "string",
"address": "string",
"city": "string",
"state": "string",
"county": "string",
"zip": "string",
"carrier": "Verizon Wireless",
"phoneType": "landline",
"areaCode": "202",
"areaName": "Washington",
"timezone": "America/New_York",
"coordinates": {
"lat": 0.0,
"lng": 0.0
},
"countryCode": "US"
}
]
}
}
Status Codes
| Status | Meaning |
|---|---|
200 | Lookup ran. Inspect body.found. |
400 | Phone missing or not a valid 10/11-digit US number. |
502 | Lookup service unavailable. |