Location Signals
Receive key locations signals associated with an individual to flag suspicious activities or validate identities.
Location Signals enables you to retrieve a list of all known locations of a given contact.
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"
}],
}'
{
"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"
}
]
}
Location Signals Response Properties
Property Name | Type | Description |
---|---|---|
locations[n].city | string | The city of a given location |
locations[n].region | string | The region or state of a given location |
locations[n].regionCode | string | The two letter region code (state code) of a given location |
locations[n].country | string | The country of a given location |
locations[n].countryCode | string | The two letter country code (ISO-3166) of a given location |
locations[n].postalCode | string | The postal (ZIP) code of a given location |
locations[n].formatted | string | A common, formatted string of the location |
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 1 month ago