---
title: "Api Isw Events"
method: GET
path: "/api/v2/isw/events"
---

# Api Isw Events

`GET /api/v2/isw/events`

## Request

- Base URL: `https://orcalayer.com` (the document declares no server; this is the origin it was published from)
- URL: `https://orcalayer.com/api/v2/isw/events`
- Auth: none declared

ISW Territory events — changes in control/advance status.

v3 (post-2026-04-26): events are per-subscription. Each event includes
subscription context (label, check_type, geometry-derived coverage/distance,
market_slug_pattern). Backward-compat fields (city/event_type/severity/details/timestamp)
are preserved.

Query params:
  hours          — lookback window (default 24, max 720)
  city           — filter by city name
  subscription_id — filter by specific subscription
  check_type     — filter by 'single' / 'enter' / 'entirety'
  min_severity   — return only events at or above this severity
                   (SAFE / LOW / MEDIUM / HIGH / CRITICAL)
  limit          — max events (default 50, max 200)

## Query parameters

- `hours` integer
- `city` string
- `limit` integer
- `subscription_id` integer
- `check_type` string
- `min_severity` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/orcalayer/apis/orcalayer-api.md) · [All operations](https://skmtc.dev/orcalayer/apis/orcalayer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/orcalayer/apis/orcalayer-api/revisions/5d1d509daba6?raw)