Employment Signals

Employment 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 socialProfiles keys.

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

{
"employment": {
    "current" : true,
    "company" : "ID Fraud, Inc.",
    "title" : "Chief Technology Officer",
		"start": {
	      "year": 2010,
	      "month": 6,
	      "day": 1
	    }
  },
"socialProfiles": {
    "linkedInUrl" : "https://www.linkedin.com/in/sallysmi"
  }
}

socialProfiles.linkedInUrl string URL to the LinkedIn profile on the social platform.

Employment Signals Properties
name string	The name of the organization/place of employment.
current boolean	Indicator of whether or not this is the current place of employment.
title string	Job or position title.
start object	Object representing start date, with properties for `year`, `month` and `day` returned as integers.
socialProfiles.linkedInUrl string	URL to the LinkedIn profile on the social platform.

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.