Job Changes | Kooperativa API

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.

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)

Code examples

cURLbash

# 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_..."

JavaScriptjs

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

{
  "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
}