The Contact Append API will return results based on the selected output type. The below displays all the fields that can be returned by each output type.

Output based on Address as input

  • First Name
  • Last Name
  • Address
  • City
  • State
  • Zip
  • Country

Output based on Phone with "Best" match type

  • First Name
  • Last Name
  • Phone
  • Line Type

Output based on phone with "Mobile" match type

  • First Name
  • Last Name
  • Mobile Phone

Output based on phone with "Multiple" match type

  • First Name
  • Last Name
  • Phone
  • Line Type
  • Alt Phone 1
  • Alt Line Type 1
  • Alt Phone 2
  • Alt Line Type 2
  • Alt Phone 3
  • Alt Line Type 3
  • Alt Phone 4
  • Alt Line Type 4
  • Alt Phone 5
  • Alt Line Type 5

Output based on email

  • First Name
  • Last Name
  • Email Address

Linetype Note -- Due to factors like number portability, there is up to a 10% inaccuracy with the linetype result.

Example Response

Here's the output of the above API call, in JSON.

{
  "versium": {
    "version":"2.0",
    "match_counts":{
      "address":1,
      "email":1
     },
      "num_matches":1,
       "num_results":1,
        "query_id":"48f9238a-ba98-4c45-97df-74f405c97527",
        "query_time":7.340619087219238,
        "results":[
          {
             "First Name":"Veronica",
             "Last Name":"Queck",
             "Address":"18804 10TH PL W",
             "City":"Kirklan",
             "State":"WA",
             "Zip":"98033",
             "Country":"US",  
             "Email Address":"veronica.quec[email protected]"
      } 
    ], 
    "input_query":{ 
      "first":"veronica"
       "last":"queck"
       "zip":"98117"
    }
  }
}