IP Address Signals

IP Address Signals enables you to retrieve a list of all known IP Addresses and associated metadata of a given contact. These signals will be returned within the ipAddresses 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"
    }],
  }'

{
  "ipAddresses": [
    {
      "id": "192.158.1.38",
      "firstSeenMs": 1350021600,
      "lastSeenMs": 1640415600,
      "confidence": 0.95
    }
  ]
}

IP Address Signals Response Properties

Property Name	Type	Description
ipAddresses.id	string	The IP address associated with an individual. (Usually IPv4)
ipAddresses.firstSeenMs	long	The first time this IP was seen by Fideo, in milliseconds (13 digit timestamp)
ipAddresses.lastSeenMs	long	The most recent time this IP was seen by Fideo, in milliseconds (13 digit timestamp)
ipAddresses.observations	integer	The number of times in our graph we've seen of an IP connected to the individual
ipAddresses.confidence	double	Numerical score of confident we are that this IP belongs to the individual (0.0-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.