verify_phone_owner Tool - Contact Center Compliance

The verify_phone_owner tool verifies if a name and/or address matches the current owner of a phone number. Use this to confirm the person who gave consent is still the phone owner.

When to Use

Use this tool when you have contact information (name, address) and want to verify it matches the phone number owner before calling.

Parameters

string

required

10-digit phone number to verify (e.g., "5039367187").

string

First name to verify (50 characters max).

string

Last name to verify (50 characters max). Required if no consentDate provided.

string

Address line 1 (30 characters max).

string

Address line 2 (30 characters max).

string

City (25 characters max).

string

2-letter state code.

string

5-digit zip code.

Date consent was given in YYYYMMDD format. Required if no lastName provided.

string

Your internal reference ID (50 characters max). Returned in response.

API key. Only required if not provided via the x-dncscrub-api-key HTTP header.

Response

boolean

Whether the API call succeeded.

string

The phone number verified.

string

Your reference ID if provided.

string

Verification result code:

N - Name does not match
YA - Name matches with full address match
YPA - Name matches with partial address match
YL - Name matches and phone is a landline
Y - Name matches (no address match)
YP - Phone ownership unchanged since consent date
YX - Identity verified via high-confidence sources
U - Unknown (no records to verify)

string

Human-readable explanation of the verification code.

boolean

true if identity verified (any Y code).

string

Phone type code: L (Landline), W (Wireless), V (VoIP), N (Not available), O (Other).

string

Human-readable phone type.

Examples

Request
Verified
Not Verified

{
  "phone": "5039367187",
  "firstName": "John",
  "lastName": "Smith",
  "address1": "123 Main St",
  "city": "Portland",
  "state": "OR",
  "postalCode": "97201"
}

{
  "success": true,
  "phone": "5039367187",
  "verificationCode": "YA",
  "verificationDescription": "Name matches phone number with full address match",
  "isVerified": true,
  "phoneType": "W",
  "phoneTypeDescription": "Wireless"
}

{
  "success": true,
  "phone": "5039367187",
  "verificationCode": "N",
  "verificationDescription": "Name does not match specified phone number",
  "isVerified": false,
  "phoneType": "W",
  "phoneTypeDescription": "Wireless"
}

Usage Notes

Provide as much information as possible for best match results
Either lastName or consentDate is required
Address matching improves confidence level
Use referenceId to correlate responses with your internal records

​When to Use

​Parameters

​Response

​Examples

​Usage Notes

When to Use

Parameters

Response

Examples

Usage Notes