Guides

IP Address Signals

Receive IP Address signals associated with an individual to flag suspicious activities or validate identities.

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 NameTypeDescription
ipAddresses.idstringThe IP address associated with an individual. (Usually IPv4)
ipAddresses.firstSeenMslongThe first time this IP was seen by Fideo, in milliseconds (13 digit timestamp)
ipAddresses.lastSeenMslongThe most recent time this IP was seen by Fideo, in milliseconds (13 digit timestamp)
ipAddresses.observationsintegerThe number of times in our graph we've seen of an IP connected to the individual
ipAddresses.confidencedoubleNumerical score of confident we are that this IP belongs to the individual (0.0-1.0)

Response Codes & Errors

Response CodesMessage
200 - OKYour request was successful
204 - No ContentIndividual is not found within Fideo's Identity Graph
400 - Bad RequestYour request was invalid
500 - Server ErrorSomething is broken on Fideo'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.