Person Signals

Receive key demographic signals associated with an individual to flag suspicious activities or validate identities.

Person Signals enables you to retrieve a list of key demographic attributes such as, age, age range, gender and general location of a given individual.

curl -X POST \ \
  -H 'Authorization: Bearer {Your API Key}' \
  -H "Content-Type: application/json" \
  -d '{
  "emails": [
    "[email protected]"
  "phones": [
  "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": ""
    }, {
    "service": "github",
    "url": ""
  "name": {
    "first": "Karen",
    "middle": "L",
    "last": "Jackson",
    "aliases": [
        "first": "Kitty",
        "last": "Smith"
  "demographics": {
    "age": 39,
    "ageRange": "31-40",
    "gender": "Female",
    "locationGeneral": "Denver, Colorado, United States"

Person Signal Properties

Property NameTypeDescription
namearrayArray of names for the individual
name[n].firststringThe first name of the individual.
name[n].middlestringThe middle name of the individual.
name[n].laststringThe family name (last name) of the individual.
name[n].aliasesarrayArray of alias, or other known names for an individual
name[n].aliases[n].firststringThe first name of the additional name / alias.
name[n].aliases[n].middlestringThe middle name of the additional name / alias.
name[n].aliases[n].laststringThe last name of the additional name / alias.
demographics.ageintegerThe age of the individual.
demographics.ageRangestringAn age range of the individual, in 10 year increments.
demographics.genderstringThe gender of the individual: Male or Female.
demographics.locationGeneralstringThe general location of the individual (City, State, or Country).

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.