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

# Reverse Phone ID Append

> Appends phone number information based on name and address data

## Request

### Headers

<ParamField header="loginId" type="string" required>
  Your API Key (LoginId from your DNCScrub account)
</ParamField>

### Query Parameters

<ParamField query="FirstName" type="string" required>
  First name
</ParamField>

<ParamField query="LastName" type="string" required>
  Last name
</ParamField>

<ParamField query="Address1" type="string" required>
  Street address
</ParamField>

<ParamField query="City" type="string" required>
  City name
</ParamField>

<ParamField query="State" type="string" required>
  State abbreviation
</ParamField>

<ParamField query="Zip" type="string" required>
  ZIP code
</ParamField>

## Output parameters

| Field           | Description                            |
| --------------- | -------------------------------------- |
| `Phone`         | Appended 10-digit phone number         |
| `FirstName`     | First name associated with the address |
| `LastName`      | Last name associated with the address  |
| `MiddleInitial` | Middle initial                         |
| `BusinessName`  | Business name if applicable            |
| `Address1`      | Primary address line                   |
| `Address2`      | Secondary address line                 |
| `City`          | City name                              |
| `State`         | State abbreviation                     |
| `Zip`           | ZIP code                               |
| `Score`         | Quality/confidence score               |
| `Category`      | Classification category                |
| `DPV`           | Delivery Point Validation code         |
| `Rectype`       | Record type                            |
| `Telconame`     | Telecommunications company name        |
| `DACode`        | Delivery Area code                     |

## Example Request

<CodeGroup>
  ```bash cURL theme={null}
  curl --location --request GET \
    'https://dataapi.dncscrub.com/v1.4/Data/PhoneIDAppend
      ?FirstName=John
      &LastName=Consumer
      &Address1=123%20Birch%20St
      &City=Beaverton
      &State=OR
      &Zip=97008' \
    --header 'loginId: YOUR_API_KEY'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://dataapi.dncscrub.com/v1.4/Data/PhoneIDAppend?FirstName=John&LastName=Consumer&Address1=123%20Birch%20St&City=Beaverton&State=OR&Zip=97008',
    {
      method: 'GET',
      headers: {
        'loginId': 'YOUR_API_KEY'
      }
    }
  );
  const data = await response.json();
  console.log(data);
  ```

  ```csharp C# theme={null}
  using (var client = new HttpClient())
  {
      client.DefaultRequestHeaders.Add("loginId", "YOUR_API_KEY");

      var response = await client.GetAsync(
          "https://dataapi.dncscrub.com/v1.4/Data/PhoneIDAppend?FirstName=John&LastName=Consumer&Address1=123%20Birch%20St&City=Beaverton&State=OR&Zip=97008"
      );

      var result = await response.Content.ReadAsStringAsync();
      Console.WriteLine(result);
  }
  ```
</CodeGroup>

<ResponseExample>
  ```json Response theme={null}
  {
    "Score": 100,
    "Category": "I ",
    "LastName": "CONSUMER",
    "FirstName": "JOHN",
    "MiddleInitial": "W",
    "BusinessName": "",
    "Address1": "123 BIRCH ST",
    "Address2": "",
    "City": "BEAVERTON",
    "State": "OR",
    "Zip": "97008",
    "DPV": "Y",
    "Phone": "7075276405",
    "Rectype": "R",
    "Telconame": "",
    "DACode": " ",
    "ResponseCode": null
  }
  ```
</ResponseExample>