> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dncscrub.com/llms.txt
> Use this file to discover all available pages before exploring further.

# verify_phone_owner Tool

> Verify if a name and/or address matches the phone number owner

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

<ParamField body="phone" type="string" required>
  10-digit phone number to verify (e.g., `"5039367187"`).
</ParamField>

<ParamField body="firstName" type="string">
  First name to verify (50 characters max).
</ParamField>

<ParamField body="lastName" type="string">
  Last name to verify (50 characters max). Required if no `consentDate` provided.
</ParamField>

<ParamField body="address1" type="string">
  Address line 1 (30 characters max).
</ParamField>

<ParamField body="address2" type="string">
  Address line 2 (30 characters max).
</ParamField>

<ParamField body="city" type="string">
  City (25 characters max).
</ParamField>

<ParamField body="state" type="string">
  2-letter state code.
</ParamField>

<ParamField body="postalCode" type="string">
  5-digit zip code.
</ParamField>

<ParamField body="consentDate" type="string">
  Date consent was given in `YYYYMMDD` format. Required if no `lastName` provided.
</ParamField>

<ParamField body="referenceId" type="string">
  Your internal reference ID (50 characters max). Returned in response.
</ParamField>

<ParamField body="loginId" type="string">
  API key. Only required if not provided via the `x-dncscrub-api-key` HTTP header.
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  Whether the API call succeeded.
</ResponseField>

<ResponseField name="phone" type="string">
  The phone number verified.
</ResponseField>

<ResponseField name="referenceId" type="string">
  Your reference ID if provided.
</ResponseField>

<ResponseField name="verificationCode" type="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)
</ResponseField>

<ResponseField name="verificationDescription" type="string">
  Human-readable explanation of the verification code.
</ResponseField>

<ResponseField name="isVerified" type="boolean">
  `true` if identity verified (any `Y` code).
</ResponseField>

<ResponseField name="phoneType" type="string">
  Phone type code: `L` (Landline), `W` (Wireless), `V` (VoIP), `N` (Not available), `O` (Other).
</ResponseField>

<ResponseField name="phoneTypeDescription" type="string">
  Human-readable phone type.
</ResponseField>

## Examples

<Tabs>
  <Tab title="Request">
    ```json theme={null}
    {
      "phone": "5039367187",
      "firstName": "John",
      "lastName": "Smith",
      "address1": "123 Main St",
      "city": "Portland",
      "state": "OR",
      "postalCode": "97201"
    }
    ```
  </Tab>

  <Tab title="Verified">
    ```json theme={null}
    {
      "success": true,
      "phone": "5039367187",
      "verificationCode": "YA",
      "verificationDescription": "Name matches phone number with full address match",
      "isVerified": true,
      "phoneType": "W",
      "phoneTypeDescription": "Wireless"
    }
    ```
  </Tab>

  <Tab title="Not Verified">
    ```json theme={null}
    {
      "success": true,
      "phone": "5039367187",
      "verificationCode": "N",
      "verificationDescription": "Name does not match specified phone number",
      "isVerified": false,
      "phoneType": "W",
      "phoneTypeDescription": "Wireless"
    }
    ```
  </Tab>
</Tabs>

## 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