Economic Signals

Receive key economic platform signals for additional context

Economic Signals enables you to retrieve a set of signals about a person's economic details.

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": ""
"economic": {
  "dwellingType": "S",
  "homeOwnership": "R",
  "maritalStatus": "M",
  "presenceOfChildren": "Y",
  "income": "$80,000 - $100,000",
  "netWorth": "$450,000"

Economic Signals Response Properties

Property NameTypeDescription
dwellingTypestringType of dwelling unit, such as Apartment, Multi-Family Home, or Single-Family Home
homeOwnershipstringRental or Owner
maritalStatusstringMarried or Single
presenceOfChildrenstringY (yes) or N (no) for whether the household has children in it.
incomestringEstimated income range.
netWorthstringEstimated total net worth of the individual.

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.