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, Non IDs, Panorama IDs, MAIDs 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
curl -X POST \
https://api.fullcontact.com/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"
}],
"maids": ["ape2ch30-pifn-cbvi-30yy-nia-zex7aw5u"],
"li_nonid": "-CmQui5eT6tqBVqQ874WGCv4DNO_taXJOAxVlQ",
"panoramaId": "294293d141c731300758a10feda14945c111e0abcd04c8208f09ff058781337b"
}'
{
"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
}
....
}
],
"maids": [
{
"id": "ape2ch30-pifn-cbvi-30yy-nia-zex7aw5u",
"type": "aaid",
"firstSeenMs": 1350021600,
"lastSeenMs": 1640415600,
"observations": 100,
"confidence": 0.87
}
....
}
],
"name": [
"givenName" : "Sally",
"familyName" : "Smith",
],
"nonIds": [
{
"id": "ape2ch30-pifn-cbvi-30yy-nia-zex7aw5u",
"firstSeenMs": 1350021600,
"lastSeenMs": 1640415600,
"observations": 100,
"confidence": 0.87
}
....
}
],
"panoIds": [
{
"id": "294293d141c731300758a10feda14945c111e0abcd04c8208f09ff058781337b",
"firstSeenMs": 1350021600,
"lastSeenMs": 1640415600,
"observations": 100,
"confidence": 0.87
}
....
}
],
"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 listQueryable | The persistent generated unique identifier for the provided multi field payload. |
name.givenName string | The given name (first name) of the individual. |
name.familyName string | The family name (last name) of the individual. |
demographics.age integer | The age of the individual. |
demographics.ageRange string | An age range of the individual. |
demographics.gender string | The gender of the individual. |
locations[n].formatted string | The formatted location. |
socialProfiles.twitterUrl string | URL to the Twitter profile on the social platform. |
socialProfiles.linkedInUrl string | URL to the LinkedIn profile on the social platform. |
employment.name string | The name of the organization/place of employment. |
employment.current boolean | Indicator of whether or not this is the current place of employment. |
employment.title string | Job 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) |
maids.id string | The AAID or IDFA associated with an individual. |
maids.type string | Either AAID or IDFA |
maids.firstSeen string | The timestamp (YYYY-MM-DD) of the first time FullContact has seen a given MAID. |
maids.lastSeen string | The timestamp (YYYY-MM-DD) of the last time FullContact has seen a given MAID. |
maids.observations integer | The number of observations in our graph we've seen of a MAID connected to a person's profile based on the associated inputs |
maids.confidence string | Numerical score of how the inputs provided relate to a person's MAID (0-1.0) |
nonIds.id string | The web id associated with an individual. |
nonIds.firstSeen string | The timestamp (YYYY-MM-DD) of the first time FullContact has seen a given web non ID. |
nonIds.lastSeen string | The timestamp (YYYY-MM-DD) of the last time FullContact has seen a given web non ID. |
nonIds.observations integer | The number of observations in our graph we've seen of a web non ID connected to a person's profile based on the associated inputs |
nonIds.confidence string | Numerical score of how the inputs provided relate to a person's web non ID (0-1.0) |
panoIds.id string | The Panorama digital id associated with an individual. |
panoIds.firstSeen string | The timestamp (YYYY-MM-DD) of the first time FullContact has seen a given Panorama ID. |
panoIds.lastSeen string | The timestamp (YYYY-MM-DD) of the last time FullContact has seen a given Panorama ID. |
panoIds.observations integer | The number of observations in our graph we've seen of a Panorama ID connected to a person's profile based on the associated inputs |
panoIds.confidence string | Numerical score of how the inputs provided relate to a person's Panorama ID (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 Codes | Message |
---|---|
200 - OK | Your request was successful |
204 - No Content | Individual is not found within FullContact's Identity Graph |
400 - Bad Request | Your request was invalid |
500 - Server Error | Something is broken on FullContact's side. If you encounter this, please contact us at [email protected] for assistance. |
503 - Service Unavailable | There is a transient downstream error condition. We include a 'Retry-After' header dictating when to attempt the call again. |
Updated 3 months ago