Professional Signals

Professional Signals enables you to retrieve the current place of employment of a given contact along with when the individual began that position and their LinkedIn profile. These signals will be returned within the employment and education keys.

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"
    }],
  }'

{
  "employment": [
    {
      "current": true,
      "company": "ID Fraud, Inc.",
      "domain": "idfraud.ai",
      "title": "Chief Technology Officer",
      "start": {
        "year": 2023,
        "month": 10,
        "day": 18
      }
    },
    {
      "current": false,
      "company": "She Sells Sea Shells, LLC",
      "domain": "shesells.seashells",
      "title": "Marketing Director",
      "start": {
        "year": 2018,
        "month": 10,
        "day": 1
      },
      "end": {
        "year": 2020,
        "month": 2,
        "day": 1
      }
    }
  ],
  "education": [
    {
      "name": "Colorado State University",
      "degree": "B.S. Marketing Science",
      "end": {
        "year": 2009,
        "month": 12,
        "day": 21
      }
    }
  ]
}

Professional Signals Response Properties

Property Name	Type	Description
employment[n].current	boolean	Indicator of whether or not this is the current place of employment.
employment[n].company	string	The name of the organization/place of employment
employment[n].title	string	Job or position title held by the individual.
employment[n].domain	string	The domain of the company at which the individual works
employment[n].start.year	integer	The first year the individual worked at the particular place of employment.
employment[n].start.month	integer	The first month the individual worked at the particular place of employment.
employment[n].start.day	integer	The first day the individual worked at the particular place of employment.
employment[n].end.year	integer	The last year the individual worked at the particular place of employment.
employment[n].end.month	integer	The last month the individual worked at the particular place of employment.
employment[n].end.day	integer	The last day the individual worked at the particular place of employment.
education[n].name		The name of the school the person attended
education[n].degree		The name of the degree obtained by the individual
education[n].end.year		The year the individual graduated from this school
education[n].end.month		The month the individual graduated from this school
education[n].end.day		The day the individual graduated from this school

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.