---
title: "Job change feed"
method: GET
path: "/job-change-monitors/{id}/events"
tags: ["Monitoring"]
---

# Job change feed

`GET /job-change-monitors/{id}/events`

## Request

- Base URL: `https://app.1lookup.io/api/v1`
- URL: `https://app.1lookup.io/api/v1/job-change-monitors/{id}/events`
- Auth: HTTP bearer

Job and title changes detected on a monitor's contacts, newest first. The first successful check of a contact records a `baseline` event, which is billed and never alerts. Free to read.

## Path parameters

- `id` string, required

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

A page of events.

- object
  - `success` true, required
  - `data` object, required
    - `events` JobChangeEvent[], required
      - `id` string, required
      - `profile_url` string, required
      - `label` string, nullable
      - `type` 'job_change' | 'title_change' | 'profile_unreachable' | 'baseline', required
      - `before` object, nullable
        - `title` string, nullable
        - `company` string, nullable
        - `location` string, nullable
      - `after` object, nullable
        - `title` string, nullable
        - `company` string, nullable
        - `location` string, nullable
      - `detected_at` string, date-time, required
    - `pagination` object, required
      - `page` integer, required
      - `limit` integer, required
      - `total` integer, required
      - `total_pages` integer, required

## Other responses

- `401`: `UNAUTHORIZED`: Invalid or missing API key
- `403`: `UPGRADE_REQUIRED`: The account has no paid plan, and API access needs one. Upgrade at https://app.1lookup.io/billing?tab=plan; `INSUFFICIENT_SCOPE`: The call was signed with an AI connector (MCP) sign-in, which can only reach /phone, /email, /ip and /account. Use an API key
- `404`: `NOT_FOUND`: Resource not found
- `429`: `RATE_LIMIT_EXCEEDED`: Too many requests
- `500`: `INTERNAL_ERROR`: Internal server error
- `503`: `SERVICE_UNAVAILABLE`: The lookup service, or the API key check, is temporarily unavailable. Nothing was charged; retry after `Retry-After` seconds

---

[API](https://skmtc.dev/1lookup/apis/1lookup-api.md) · [All operations](https://skmtc.dev/1lookup/apis/1lookup-api/llms.txt) · [OpenAPI document](https://skmtc.dev/1lookup/apis/1lookup-api/revisions/57b6d8ba04ac?raw)