Guides

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 NameTypeDescription
locations[n].citystringThe city of a given location
locations[n].regionstringThe region or state of a given location
locations[n].regionCodestringThe two letter region code (state code) of a given location
locations[n].countrystringThe country of a given location
locations[n].countryCodestringThe two letter country code (ISO-3166) of a given location
locations[n].postalCodestringThe postal (ZIP) code of a given location
locations[n].formattedstringA common, formatted string of the location

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.