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/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"
}],
}'
{
"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. |
Updated about 2 months ago