---
title: "Job Changes"
description: "Detect people who recently changed jobs within a time window."
---

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

# Job Changes

`GET /api/v1/person/job-changes`

Returns people who started a new job after a given timestamp. Useful for triggering outreach when someone moves to a new role.

:::tip
This is one of the most powerful endpoints for sales and recruiting. People who just changed jobs are actively settling in and often open to new tools, vendors, and conversations.
:::

## Query parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| `since` | integer | **Yes** | Unix timestamp; return people who changed jobs after this |
| `company_id` | string | No | Filter by company ID |
| `page` | integer | No | Page number (default: 1) |
| `per_page` | integer | No | Results per page (default: 10, max: 50) |

:::note
`since` is a Unix timestamp in seconds, not milliseconds. Use `Math.floor(Date.now() / 1000)` in JavaScript.
:::

## Code examples

```bash title="cURL"
# Job changes in the last 90 days
SINCE=$(python3 -c "import time; print(int(time.time()) - 90*86400)")
curl "https://kooperativa.io/api/v1/person/job-changes?since=$SINCE" \
  -H "Authorization: Bearer ik_live_..."
```

```js title="JavaScript"
const since = Math.floor(Date.now() / 1000) - 90 * 24 * 60 * 60;
const res = await fetch(
  `https://kooperativa.io/api/v1/person/job-changes?since=${since}`,
  { headers: { Authorization: `Bearer ${process.env.KOOPERATIVA_API_KEY}` } }
);
const { results, total } = await res.json();
```

## Response

```json
{
  "window_days": 90,
  "since_timestamp": 1752666406,
  "results": [
{
  "id": "556a82f4-...",
  "full_name": "Jane Doe",
  "current_title": "VP of Sales",
  "current_company": "Acme Corp",
  "geo_country_code": "US",
  "fetched_at": "2026-07-14T12:00:00Z"
}
  ],
  "total": 145347,
  "page": 1,
  "per_page": 10
}
```

Source: https://docs.kooperativa.io/people/job-changes/index.mdx