Phone Signals (old)

Receive key phone signals associated with an individual to flag suspicious activities or validate identities.

Phone Signals enables you to retrieve a list of all known phone numbers and associated phone metadata of a given contact. Additionally, any work phone numbers will be returned in clear text. These signals will be returned within the phones key.

curl -X POST \ \
  -H 'Authorization: Bearer {Your API Key}' \
  -H "Content-Type: application/json" \
  -d '{
  "emails": [
    "[email protected]"
  "phones": [
  "location": {
    "addressLine1": "123 Main Street",
    "city": "Denver",
    "region": "Colorado",
    "regionCode": "CO",
    "postalCode": "80203"
  "name": {
    "given": "Sally",
    "family": "Smith"
  "profiles": [{
    "service": "twitter",
    "username": "smith"
    }, {
    "service": "twitter",
    "userid": "123456"
    }, {
    "service": "linkedin",
    "url": ""
    }, {
    "service": "github",
    "url": ""
  "maids": ["ape2ch30-pifn-cbvi-30yy-nia-zex7aw5u"],
  "li_nonid": "-CmQui5eT6tqBVqQ874WGCv4DNO_taXJOAxVlQ",
  "panoramaId": "294293d141c731300758a10feda14945c111e0abcd04c8208f09ff058781337b"
"phones": [ 
        "label": "work",
        "value": "+19702255555",
		    "firstSeenMs": 1350021600,
        "lastSeenMs": 1640415600,
        "observations": 100,
        "confidence": 0.65       
Phone Signals Response Properties
phones.label string An indicator of the type of phone.
phones.value string The business phone of an individual, if known.
phones.firstSeen string The timestamp (YYYY-MM-DD) of the first time FullContact has seen a given phone number.
phones.lastSeen string The timestamp (YYYY-MM-DD) of the last time FullContact has seen a given phone number.
phones.observations integer The number of observations in our graph we've seen of a phone connected to a person's profile based on the associated inputs
phones.confidence string Numerical score of how the inputs provided relate to a person's phone (0-1.0)

Response Codes & Errors

Response CodesMessage
200 - OKYour request was successful
204 - No ContentIndividual is not found within FullContact's Identity Graph
400 - Bad RequestYour request was invalid
500 - Server ErrorSomething is broken on FullContact's side. If you encounter this, please contact us at [email protected] for assistance.
503 - Service UnavailableThere is a transient downstream error condition. We include a 'Retry-After' header dictating when to attempt the call again.