Demographic Signals

Demographic Signals enables you to retrieve a list of key demographic attributes such as, age, age range, gender and general location of a given contact. These signals will be returned within the demographics key.

curl -X POST \
  https://api.fullcontact.com/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"
    }],
  "maids": ["ape2ch30-pifn-cbvi-30yy-nia-zex7aw5u"],
  "li_nonid": "-CmQui5eT6tqBVqQ874WGCv4DNO_taXJOAxVlQ",
  "panoramaId": "294293d141c731300758a10feda14945c111e0abcd04c8208f09ff058781337b"
  }'

{
"demographics" : {
    "age": 40,
    "ageRange" : "31-40",
    "gender" : "female",
    "locationFormatted" : "Denver, Colorado, United States"
    }
}

Demographic Signals Response Properties
demographics.age integer	The age of the individual.
demographics.ageRange string	An age range of the individual.
demographics.gender string	The gender of the individual.
locations[n].formatted string	The formatted location.

Response Codes & Errors

Response Codes	Message
200 - OK	Your request was successful
204 - No Content	Individual is not found within FullContact's Identity Graph
400 - Bad Request	Your request was invalid
500 - Server Error	Something is broken on FullContact'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.