Email Signals

Email Signals enables you to retrieve a list of all known hashed emails and associated metadata of a given contact. These signals will be returned within the emails key.

curl -X POST \
  https://api.fideo.ai/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"
    }],
  }'

{
  "emails": [
    {
      "md5": "4ae8f6dd533de3c08481d4cc9c10e80d",
      "sha1": "f9401124f3252a97244bd84bd960b167a20116f3",
      "sha256": "8b458dd2661e2cb2f40d6676eac54f8cabc83fde59229d1fe1425d0a83c21c1f",
      "firstSeenMs": 1350021600,
      "lastSeenMs": 1640415600,
      "observations": 201,
      "confidence": 0.97,
      "activity": 0.5,
      "label": "work"
    }
  ]
}

Email Signals Response Properties

Property Name	Type	Description
emails[n].md5	string	The MD5 hash representation for a given email address.
emails[n].sha1	string	The SHA-1 hash representation for a given email address.
emails[n].sha256	string	The SHA-256 hash representation for a given email address.
emails[n].firstSeenMs	long	The first time this email was seen by Fideo, in milliseconds (13 digit timestamp)
emails[n].lastSeenMs	long	The most recent time this email was seen by Fideo, in milliseconds (13 digit timestamp)
emails[n].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[n].confidence	double	Numerical score of how the inputs provided relate to a person's hashed email (0.0-1.0)
emails[n].label	string	The type of email hash returned (work, consumer, government, mobile, etc)
emails[n].activity	double	How active the email is using Fideo's activity scoring algorithm. Higher numbers show more recent and frequent use. Score is between 0.0 and 1.0

Response Codes & Errors

Response Codes	Message
200 - OK	Your request was successful
204 - No Content	Individual is not found within Fideo's Identity Graph
400 - Bad Request	Your request was invalid
500 - Server Error	Something is broken on Fideo'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.