---
title: "Job Change Detector"
method: POST
path: "/v1/people/job-change-detector"
tags: ["Jobs Data"]
---

# Job Change Detector

`POST /v1/people/job-change-detector`

Monitor employee transitions and detect when someone has changed jobs.

## Request body

- object
  - `profile_url` string, required — Professional profile URL or identifier
  - `company_name` string — Expected company name (either company_name or company_domain is required)
  - `company_domain` string — Expected company domain (either company_name or company_domain is required)

## Response `200`

Successful job change detection

- object
  - `job_change_detected` boolean
  - `status` 'NO_CHANGE' | 'JOB_CHANGE_DETECTED' | 'NEVER_WORKED_THERE'
  - `summary` string
  - `employee_name` string
  - `expected_company` string
  - `current_company` string
  - `current_position` object
    - `title` string
    - `company` string
    - `start_date` string
    - `days_at_job` integer
    - `tenure_formatted` string
    - `is_current_position` boolean
  - `tenure_stats` object
    - `average_tenure_months` integer
    - `average_tenure_formatted` string
    - `total_positions` integer
    - `longest_tenure_months` integer
    - `longest_tenure_formatted` string
    - `shortest_tenure_months` integer
    - `shortest_tenure_formatted` string
  - `work_history` object[]
    - `title` string
    - `company` string
    - `duration` string
    - `is_present` boolean
  - `profile_found` boolean
  - `profile_url` string
  - `credits_consumed` integer

## Other responses

- `400` — Bad Request - The request was malformed or contains invalid parameters. **Common causes:** - Missing required fields - Invalid field format (e.g., malformed email) - Invalid JSON syntax - Invalid parameter values
- `401` — Unauthorized - Authentication failed. **Common causes:** - Missing X-API-Key header - Invalid or expired API key - Malformed API key
- `402` — Payment Required - Insufficient credits for this request. **Action required:** Add credits to your account at https://app.leadmagic.io/settings/billing
- `404` — Not Found - The requested resource could not be found. **Common causes:** - Profile doesn't exist or is not accessible - Company not found in our database - Invalid URL or identifier
- `429` — Too Many Requests - Rate limit exceeded. **Action required:** Check the `Retry-After` header for when to retry. **Headers returned:** - `Retry-After`: Seconds until you can retry - `RateLimit-Limit`: Your limit per minute - `RateLimit-Remaining`: Remaining requests this minute - `RateLimit-Reset`: Seconds until limit resets
- `500` — Internal Server Error - Something went wrong on our end. **Action required:** Wait 30 seconds and retry. If the problem persists, contact support@leadmagic.io

---

[API](https://skmtc.net/leadmagic/apis/leadmagic-api.md) · [All operations](https://skmtc.net/leadmagic/apis/leadmagic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/leadmagic/leadmagic-api/revisions/aa19cf9bc46a/schema)