Signals

Verify Signals provides high value information on contact identifiers in order to model risk. Receive rich, data intelligence signals associated with an individual to further understand current, active and/or historical elements to ingest into algorithms in order to flag suspicious activities or validate identities.

Signals spans both the digital and terrestrial ecosystems along with providing linkages between how individuals represent themselves both professionally and personally.

For each contact identifier being passed back in Verify Signals such as, phones, and IP Addresses you will receive a max of 5 additional identifiers for each. For hashed emails, you will receive a max of 20 additional identifiers.

Should you wish to only receive certain Signals elements, check out our various Signals offerings to meet your business needs.

Download Here: [Verify Signals Data Dictionary](s3://fullcontact-cx-static-assets/docs/FullContact - Verify Data Dictionary - Signals-1.pdf)

curl -X POST \
  https://api.full.id/v3/verify.signals \
  -H 'Authorization: Bearer {Your API Key}' \
  -H "Content-Type: application/json" \
  -d '{
  "emails": [
    "[email protected]"
  ],
  "phones": [
    "+15552227799"
  ],
  "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": "https://www.linkedin.com/in/sallysmi"
    }, {
    "service": "github",
    "url": "https://www.github.com/smith"
    }]
  }'
{
  "personIds": [
      "c0VAsuEb4DRPuXmEXLutGitk-Hq9xUMautmqzyfuHpZyl3EP"
    ],
  "emails": [
      {
        "md5": "4ae8f6dd533de3c08481d4cc9c10e80d",
        "sha1": "f9401124f3252a97244bd84bd960b167a20116f3",
        "sha256": "8b458dd2661e2cb2f40d6676eac54f8cabc83fde59229d1fe1425d0a83c21c1f",
	"firstSeenMs": 1350021600,
        "lastSeenMs": 1640415600,
        "observations": 201,
        "confidence": 0.97    
      }
    ....
    }
  ],
  "phones": [ 
      {
        "label": "work",
        "value": "+19702255555",
	"firstSeenMs": 1350021600,
        "lastSeenMs": 1640415600,
        "observations": 100,
        "confidence": 0.65       
      }
    ....
    }
  ],
    }
  ],
  "name": [ 
    	"givenName" : "Sally",
    	"familyName" : "Smith",
  ],
  "ipAddresses": [ 
       {
        "id": "192.158.1.38",
	"firstSeenMs": 1350021600,
        "lastSeenMs": 1640415600,
        "confidence": 0.37       
      }
    ....
    }
  ],
  "socialProfiles": {
    "twitterUrl" : "https://twitter.com/smit",
    "linkedInUrl" : "https://www.linkedin.com/in/sallysmi"
  },
  "demographics" : {
   	"age": 40,
    "ageRange" : "31-40",
    "gender" : "female",
    "locationFormatted" : "Denver, Colorado, United States"
    },
  "employment": {
    "current" : true,
    "company" : "ID Fraud, Inc.",
    "title" : "Chief Technology Officer"
  }
}
Signals Response Properties
personIds listQueryableThe persistent generated unique identifier for the provided multi field payload.
name.givenName stringThe given name (first name) of the individual.
name.familyName stringThe family name (last name) of the individual.
demographics.age integerThe age of the individual.
demographics.ageRange stringAn age range of the individual.
demographics.gender stringThe gender of the individual.
locations[n].formatted stringThe formatted location.
socialProfiles.twitterUrl stringURL to the Twitter profile on the social platform.
socialProfiles.linkedInUrl stringURL to the LinkedIn profile on the social platform.
employment.name stringThe name of the organization/place of employment.
employment.current booleanIndicator of whether or not this is the current place of employment.
employment.title stringJob or position title.
emails.md5 string The MD5 hash representation for a given email address.
emails.sha1 string The SHA-1 hash representation for a given email address.
emails.sha256 string The SHA-256 hash representation for a given email address.
emails.firstSeen string The timestamp (YYYY-MM-DD) of the first time FullContact has seen a given email address.
emails.lastSeen string The timestamp (YYYY-MM-DD) of the last time FullContact has seen a given email address.
emails.observations integer The number of observations in our graph we've seen of an email connected to a person's profile based on the associated inputs
emails.confidence string Numerical score of how the inputs provided relate to a person's hashed email (0-1.0)
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)
ipAddresses.id string The IP address linked to a MAID that is associated with an individual.
ipAddresses.firstSeen string The timestamp (YYYY-MM-DD) of the first time FullContact has seen a given IP Address.
ipAddresses.lastSeen string The timestamp (YYYY-MM-DD) of the last time FullContact has seen a given IP Address.
ipAddresses.confidence string Numerical score of how the inputs provided relate to a person's IP Address (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.