This operation is a composite of PhoneAppend and BusinessPhoneAppendCompositePhoneAppend provides the convenience for developers to code to one operation and is able to append phone numbers for business and residential contacts A parameter “IsBusiness” allows the client to specify whether the contact is a business or not. If left blank, the service can make the determination on its own, however, this increases the response time from the request.

CompositePhoneAppend makes use of additional name parsing logic when the IsBusiness parameter is not provided a value of True or False. This additional logic adds an increase in response time due to name-based logic that is performed on the inputs provided. It is recommended to specify a value for the IsBusiness parameter when used in applications that are time sensitive.

URL Endpoints

CompositePhoneAppend Inputs

NameTypeDescription
NameStringThe Name of the contact to return the telephone number.
AddressStringThe Address of the contact to return the telephone number.
CityStringThe City of the contact to return the telephone number.
StateStringThe State of the contact to return the telephone number.
Postal CodeStringThe Postal Code of the contact to return the telephone number.
IsBusinessStringA determination of the type of contact to append a phone number to. Values to submit are either “True”,”False” or leave field blank to allow the service to make the determination on its own. We leave this up to the client to make the determination based on how they intend to use the service
LicenseKeyStringYour license key to use the service.
Sign up for a free trial key at
https://www.serviceobjects.com/products/phone/phone-append

CompositePhoneAppend Outputs

NameTypeDescription
PhoneStringThe landline phone number matching the found contact.
NameStringThe Name of the person matching the found contact
AddressStringThe Address of the person matching the found contact.
CityStringThe City of the person matching the found contact.
StateStringThe State of the person matching the found contact
PostalCodeStringThe Postal Code of the person matching the found contact.
IsResidentialStringA determination of the matching contact is a business number or not.
CertaintyStringA rating scale of the accuracy of the matching contact given the supplied inputs. Values can be “Low” “Medium” or “High”
LineTypeStringA determination of the phone carrier line type. Possible values are “Landline”, “Wireless”, “VOIP”, or “Unknown”. This operation favors landline results but does have the opportunity to return a small percentage of wireless numbers.
DebugStringAn internal field used for testing our services
ErrorErrorSee Errors

References