PhoneAppend

PhoneAppend returns the phone number associated with a given address. It also determines if the phone number is on the Federal Trade Commission's do-not-call list and if the address is on the Direct Marketing Association's do-not-mail list.

Resource URL

JSON endpoint:

https://OnDemandServer/rest/PhoneAppend/results.json

XML endpoint:

https://OnDemandServer/rest/PhoneAppend/results.xml

For a list of Spectrum OnDemand servers, see Connecting to Spectrum OnDemand Servers.

Example with JSON Response

The following example requests a JSON response:

https://spectrum.precisely.com/rest/PhoneAppend/results.json​?Data.AddressLine1=2225+American+Drive&Data.City=Neenah&Data.StateProvince=WI

The JSON returned by this request would be:

{"Output": [{
   "AddressLine1": "2225 AMERICAN DR",
   "AddressLine2": "",
   "AddressLine3": "",
   "AddressLine4": "",
   "CanLanguage": "",
   "City": "Neenah",
   "Confidence": "86",
   "Country": "",
   "DoNotCallList": "FTC list",
   "FirmName": "",
   "PhoneNumber": "9207313833",
   "PhoneNumber.Status": "Connected",
   "PhoneNumber.Type": "0 Landline",
   "PostalCode": "54956",
   "StateProvince": "WI",
   "USUrbanName": "",
   "user_fields": []
}]}

Example with XML Response

The following example requests an XML response:

https://spectrum.precisely.com/rest/PhoneAppend/results.xml​?Data.AddressLine1=2225+American+Drive&Data.City=Neenah&Data.StateProvince=WI

The XML returned by this request would be:

<xml.PhoneAppendResponse xmlns="http://www.precisely.com/spectrum/services/PhoneAppend">
   <Output>
      <Row>
         <AddressLine1>2225 AMERICAN DR</AddressLine1>
         <AddressLine2/>
         <AddressLine3/>
         <AddressLine4/>
         <CanLanguage/>
         <City>Neenah</City>
         <Confidence>86</Confidence>
         <Country/>
         <DoNotCallList>FTC list</DoNotCallList>
         <FirmName/>
         <PhoneNumber>9207313833</PhoneNumber>
         <PhoneNumber.Status>Connected</PhoneNumber.Status>
         <PhoneNumber.Type>0 Landline</PhoneNumber.Type>
         <PostalCode>54956</PostalCode>
         <StateProvince>WI</StateProvince>
         <USUrbanName/>
         <user_fields/>
      </Row>
   </Output>
</xml.PhoneAppendResponse>