Signals
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: Data Dictionary
curl -X POST \
https://api.fideo.ai/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,
"activity": 0.15
}
....
}
],
"phones": [
{
"label": "work",
"value": "+19702255555",
"firstSeenMs": 1350021600,
"lastSeenMs": 1640415600,
"observations": 100,
"confidence": 0.65
}
....
}
],
}
],
"name": [
"givenName" : "Sally",
"familyName" : "Smith",
"aliases" : [
{
"first": "Sugar",
"last": "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"
},
"locations": [
{
"city": "Denver",
"region": "Colorado",
"regionCode": "CO",
"country": "United States",
"countryCode": "US",
"formatted": "Denver, Colorado, United States"
},
{
"city": "Tokyo",
"country": "Japan",
"countryCode": "JP",
"formatted": "Tokyo, Japan"
}
],
"education": [
{
"name": "Colorado State University",
"degree": "B.S. Marketing Science",
"end": {
"year": 2009,
"month": 12,
"day": 21
}
}
]
}
}
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) |
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 5 months ago