Skip to main content
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

​
phone
string
required
10-digit phone number to verify (e.g., "5039367187").
​
firstName
string
First name to verify (50 characters max).
​
lastName
string
Last name to verify (50 characters max). Required if no consentDate provided.
​
address1
string
Address line 1 (30 characters max).
​
address2
string
Address line 2 (30 characters max).
​
city
string
City (25 characters max).
​
state
string
2-letter state code.
​
postalCode
string
5-digit zip code.
​
consentDate
string
Date consent was given in YYYYMMDD format. Required if no lastName provided.
​
referenceId
string
Your internal reference ID (50 characters max). Returned in response.
​
loginId
string
API key. Only required if not provided via the x-dncscrub-api-key HTTP header.

​
Response

​
success
boolean
Whether the API call succeeded.
​
phone
string
The phone number verified.
​
referenceId
string
Your reference ID if provided.
​
verificationCode
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)
​
verificationDescription
string
Human-readable explanation of the verification code.
​
isVerified
boolean
true if identity verified (any Y code).
​
phoneType
string
Phone type code: L (Landline), W (Wireless), V (VoIP), N (Not available), O (Other).
​
phoneTypeDescription
string
Human-readable phone type.

​
Examples

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

​
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