> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cufinder.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Job Changes API

> The Job Changes API returns people who changed roles within a date range — new jobs, promotions, lateral title moves, and first jobs. Each record includes the person's LinkedIn URL and their from/to company and title.

## Common Use Cases

Track when people change roles — new jobs, promotions, and title moves — across any date range.

* **Champion Tracking:** Following contacts who move to new companies.
* **New-Buyer Alerts:** Reaching decision-makers who just started a role.
* **Recruiting:** Spotting promotions and moves for sourcing.
* **Relationship Mapping:** Watching talent flow between companies.

<Badge color="blue" size="lg" icon="star" className="mt-3">
  Credit usage is 1 per request.
</Badge>

## Attributes

<ParamField body="start_date" type="string" default="2026-05-15" required>
  Start of the date range, formatted `YYYY-MM-DD`.
</ParamField>

<ParamField body="end_date" type="string" default="2026-08-15" required>
  End of the date range, formatted `YYYY-MM-DD`.
</ParamField>

<ParamField body="type" type="string" required>
  The kind of job change to return. Allowed values:

  | Type                    | Meaning                                            |
  | ----------------------- | -------------------------------------------------- |
  | `company_change`        | Person moved from company A to company B.          |
  | `promotion`             | Same company, seniority or title jumped up.        |
  | `lateral_title_change`  | Same company, title changed but no seniority jump. |
  | `no_company_to_company` | Person had no company and now has one.             |
</ParamField>

<ParamField body="page" type="integer">
  Page number for paginated results.
</ParamField>

## Response

<CodeGroup>
  ```json Response theme={null}
  {
      "status": 1,
      "data": {
          "confidence_level": 97,
          "query": {
              "start_date": "2026-05-15",
              "end_date": "2026-08-15",
              "type": "promotion",
              "page": 1
          },
          "job_changes": [
              {
                  "type": "promotion",
                  "linkedin_url": "linkedin.com/in/sabmartinez",
                  "detected_at": "2026-08-14T23:59:32.286Z",
                  "from": {
                      "company_linkedin_url": "linkedin.com/company/ryan",
                      "company_linkedin_id": "11070",
                      "company_name": "ryan",
                      "title": "property tax consultant"
                  },
                  "to": {
                      "company_linkedin_url": "linkedin.com/company/ryan",
                      "company_linkedin_id": "11070",
                      "company_name": "ryan",
                      "title": "senior consultant property tax"
                  }
              }
          ],
          "credit_count": 4694
      }
  }
  ```
</CodeGroup>

## Related APIs

<CardGroup cols={2}>
  <Card title="People Signals" icon="users" href="/buying-signals/signals-apis/people-signals">
    People at companies that triggered a signal.
  </Card>

  <Card title="Person Enrichment" icon="user" href="/apis/person-enrichment">
    Enrich a person with full contact data.
  </Card>

  <Card title="Person Search" icon="search" href="/apis/person-search">
    Search 1B+ profiles with combined filters.
  </Card>

  <Card title="LinkedIn Profile Enrichment" icon="brand-linkedin" href="/apis/linkedin-profile-enrichment">
    Enrich a person from their LinkedIn profile.
  </Card>
</CardGroup>