Skip to main content
POST
/
v1
/
people
/
job-change-detector
Job Change Detector
curl --request POST \
  --url https://api.leadmagic.io/v1/people/job-change-detector \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "profile_url": "jesseoue"
}
'
{
  "job_change_detected": false,
  "status": "NEVER_WORKED_THERE",
  "summary": "Jesse Ouellette has never worked at Smartlead according to their comprehensive employment history. They are currently working at Leadmagic as Founder for 3 years. Their complete employment history shows experience at Leadmagic, Pavilion, Startree, and 7 other companies. The expected company does not appear in any current or past positions, confirming they have never been employed there.",
  "employee_name": "Jesse Ouellette",
  "expected_company": "Smartlead",
  "current_company": "Leadmagic",
  "current_position": {
    "title": "Founder",
    "company": "Leadmagic",
    "start_date": "Sep 2022",
    "days_at_job": 1111,
    "tenure_formatted": "3 years",
    "is_current_position": true
  },
  "tenure_stats": {
    "average_tenure_months": 26,
    "average_tenure_formatted": "2 years 2 months",
    "total_positions": 10,
    "longest_tenure_months": 73,
    "longest_tenure_formatted": "6 years 1 month",
    "shortest_tenure_months": 1,
    "shortest_tenure_formatted": "1 month"
  },
  "work_history": [
    {
      "title": "Founder",
      "company": "Leadmagic",
      "duration": "Sep 2022 - Present",
      "is_present": true
    },
    {
      "title": "Executive Member",
      "company": "Pavilion",
      "duration": "Aug 2019 - Present",
      "is_present": true
    },
    {
      "title": "Advisor",
      "company": "Startree",
      "duration": "Feb 2023 - Jan 2024",
      "is_present": false
    },
    {
      "title": "Advisor",
      "company": "Sales Community",
      "duration": "May 2020 - Dec 2023",
      "is_present": false
    },
    {
      "title": "Advisor",
      "company": "Astronomer",
      "duration": "Jul 2020 - Sep 2023",
      "is_present": false
    }
  ],
  "profile_found": true,
  "profile_url": "jesseoue/",
  "credits_consumed": 2
}

​
Detect Job Changes

Detect job changes for a professional by monitoring their profile against a specific company. Know instantly when your contacts move companies.

​
Endpoint Details

MetricValue
Cost3 credits per check
Job changes are a prime trigger event. People who just started a new role have budget and authority to make purchasing decisions.

​
Quick Example

curl -X POST 'https://api.leadmagic.io/v1/people/job-change-detector' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "profile_url": "linkedin.com/in/johndoe",
    "company_domain": "oldcompany.com"
  }'

​
Request Parameters

​
profile_url
string
required
Professional profile URL or username to monitor
​
company_domain
string
Expected company domain to check against (preferred)
​
company_name
string
Expected company name to check against
You must provide either company_domain or company_name to compare against.

​
Response

​
job_changed
boolean
required
Whether the person has changed jobs
​
still_employed
boolean
Whether still employed at the expected company
​
current_company
string
Current company name (if changed)
​
current_title
string
Current job title
​
expected_company
string
The company you were checking against
​
credits_consumed
number
required
Credits used (always 3)
​
message
string
required
Human-readable status message

​
Example Response - No Change

{
  "job_changed": false,
  "still_employed": true,
  "current_company": "Old Company Inc",
  "current_title": "VP of Sales",
  "expected_company": "Old Company Inc",
  "credits_consumed": 3,
  "message": "No job change detected. Still employed at expected company."
}

​
Example Response - Job Changed

{
  "job_changed": true,
  "still_employed": false,
  "current_company": "New Company Inc",
  "current_title": "Chief Revenue Officer",
  "expected_company": "Old Company Inc",
  "credits_consumed": 3,
  "message": "Job change detected. Person has moved to a new company."
}

​
Success Messages

MessageMeaning
No job change detected. Still employed at expected company.Person still at company
Job change detected. Person has moved to a new company.Person changed jobs
Never worked at the expected company.No employment record found

​
Best Practices

Run weekly checks on your top accounts to catch job changes early.
Job changers in their first 90 days are 3x more likely to buy. Reach out quickly.
When your champion moves, reach out at their new company - they already know your value.
Check multiple contacts in parallel to efficiently monitor your database.

​
Use Cases

Champion Tracking

Follow your product champions when they move to new companies.

Churn Prevention

Know when key contacts leave accounts before renewal conversations.

Trigger Campaigns

Automatically trigger outreach when contacts move to target accounts.

CRM Hygiene

Keep contact records accurate by detecting role changes.

Authorizations

​
X-API-Key
string
header
required

Your LeadMagic API key. Header name is case-insensitive (X-API-Key, X-API-KEY, x-api-key all work).

Body

application/json
​
profile_url
string
required

Professional profile URL or identifier

Example:

"jesseoue"

​
company_name
string

Expected company name (either company_name or company_domain is required)

Example:

"Smartlead"

​
company_domain
string

Expected company domain (either company_name or company_domain is required)

Example:

"smartlead.ai"

Response

Successful job change detection

​
job_change_detected
boolean
Example:

false

​
status
enum<string>
Available options:
NO_CHANGE,
JOB_CHANGE_DETECTED,
NEVER_WORKED_THERE
Example:

"NEVER_WORKED_THERE"

​
summary
string
Example:

"Jesse Ouellette has never worked at Smartlead according to their comprehensive employment history. They are currently working at Leadmagic as Founder for 3 years. Their complete employment history shows experience at Leadmagic, Pavilion, Startree, and 7 other companies. The expected company does not appear in any current or past positions, confirming they have never been employed there."

​
employee_name
string
Example:

"Jesse Ouellette"

​
expected_company
string
Example:

"Smartlead"

​
current_company
string
Example:

"Leadmagic"

​
current_position
object
​
tenure_stats
object
​
work_history
object[]
Example:
[
  {
    "title": "Founder",
    "company": "Leadmagic",
    "duration": "Sep 2022 - Present",
    "is_present": true
  },
  {
    "title": "Executive Member",
    "company": "Pavilion",
    "duration": "Aug 2019 - Present",
    "is_present": true
  },
  {
    "title": "Advisor",
    "company": "Startree",
    "duration": "Feb 2023 - Jan 2024",
    "is_present": false
  },
  {
    "title": "Advisor",
    "company": "Sales Community",
    "duration": "May 2020 - Dec 2023",
    "is_present": false
  },
  {
    "title": "Advisor",
    "company": "Astronomer",
    "duration": "Jul 2020 - Sep 2023",
    "is_present": false
  }
]
​
profile_found
boolean
Example:

true

​
profile_url
string
Example:

"jesseoue/"

​
credits_consumed
integer
Example:

2