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

# Number monitor change feed

`GET /monitors/{id}/events`

## Request

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

Changes detected on a monitor's numbers, newest first. Free.

## 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` NumberMonitorEvent[], required
      - `id` string, required
      - `phone_number` string, required
      - `label` string, nullable
      - `changes` object, required: What changed, keyed by field (status, lineType, carrier, ported, dncListed, spamRiskLevel).
      - `previous_snapshot` object, nullable
      - `current_snapshot` object, 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)