LEleadmagic
Jobs Data

Job Change Detector

Changed on

Monitor employee transitions and detect when someone has changed jobs. Costs 3 credits per check. The submitted company_name is authoritative; a company_domain lookup only adds matcher aliases. job_change_detected is true only when status is JOB_CHANGE_DETECTED. When the profile URL does not resolve, the response is status PROFILE_NOT_FOUND with resolution_reason PROFILE_NOT_FOUND and credits_consumed 0: nothing is charged.

post/v1/people/job-change-detector

Request

  • Base URL
    https://api.leadmagic.io
  • Auth
    API key in header X-API-Key

Request body

profile_urlstring required

Professional profile URL or identifier

company_namestring

Expected company name (either company_name or company_domain is required)

company_domainstring

Expected company domain (either company_name or company_domain is required)

Example request

{
  "profile_url": "alex-rivera",
  "company_name": "Example Robotics",
  "company_domain": "smartlead.ai"
}

Response

Successful job change detection

job_change_detectedboolean

true only when status is JOB_CHANGE_DETECTED.

status'NO_CHANGE' | 'JOB_CHANGE_DETECTED' | 'NEVER_WORKED_THERE' | 'AMBIGUOUS_CURRENT_EMPLOYMENT' | 'CURRENT_EMPLOYMENT_UNKNOWN' | 'PROFILE_NOT_FOUND'

NO_CHANGE: the expected employer is a current role. JOB_CHANGE_DETECTED: a different primary employer is current, or the matched role has an explicit end date with nothing current, or the expected employer is absent from history while another primary employer is current. NEVER_WORKED_THERE: the expected employer is absent from history and no primary current role is listed. AMBIGUOUS_CURRENT_EMPLOYMENT: multiple substantive current roles; not safe to call. CURRENT_EMPLOYMENT_UNKNOWN: the expected employer matched but the role carries no dates; unknown, not a change. PROFILE_NOT_FOUND: the profile URL did not resolve; credits_consumed is 0.

resolution_reason'CURRENT_COMPANY_MATCHES_EXPECTED' | 'CURRENT_COMPANY_DIFFERS_FROM_EXPECTED' | 'EXPECTED_COMPANY_NOT_FOUND_IN_HISTORY' | 'NO_CURRENT_POSITION_FOUND' | 'NO_EXPERIENCE_HISTORY_FOUND' | 'MULTIPLE_CURRENT_POSITIONS_FOUND' | 'PROFILE_NOT_FOUND'

Why the status was chosen. PROFILE_NOT_FOUND accompanies status PROFILE_NOT_FOUND.

summarystring
employee_namestring
expected_companystring
current_companystring
profile_foundboolean
profile_urlstring
credits_consumedinteger

3 per check; 0 when status is PROFILE_NOT_FOUND.

Example response

{
  "status": "NEVER_WORKED_THERE",
  "resolution_reason": "EXPECTED_COMPANY_NOT_FOUND_IN_HISTORY",
  "summary": "Alex Rivera has never worked at Example Robotics 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, Atlas Guild, Northstar Labs, 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": "Alex Rivera",
  "expected_company": "Example Robotics",
  "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": "Atlas Guild",
      "duration": "Aug 2019 - Present",
      "is_present": true
    },
    {
      "title": "Advisor",
      "company": "Northstar Labs",
      "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": "alex-rivera",
  "credits_consumed": 3
}

Changes

  • 51db6fceee34Revision changes
    • breaking

      added to the response body oneOf list for the response status

    • info

      removed from the response body allOf list for the response status

  • 9b073a75836fRevision changes
    • warning

      added the new AMBIGUOUS_CURRENT_EMPLOYMENT enum value to the response property for the response status

    • warning

      added the new CURRENT_EMPLOYMENT_UNKNOWN enum value to the response property for the response status

    • warning

      added the new PROFILE_NOT_FOUND enum value to the response property for the response status

    • info

      added the optional property to the response with the status