---
title: "List events"
method: GET
path: "/api/v1/events"
---

# List events

`GET /api/v1/events`

## Request

- Base URL: `https://dirtsignal.com`
- URL: `https://dirtsignal.com/api/v1/events`
- Auth: HTTP bearer

Returns normalized events filtered by region and record type. By default, clerk documents are narrowed to active distress signals such as liens, judgments, and lis pendens. Requires a paid account and an API key from Settings.

## Query parameters

- `region` string
- `view_id` string
- `types` string
- `limit` integer
- `include_inactive` '1'
- `include_weak` '1'

## Response `200`

Event list

- object
  - `events` Event[]
    - `source_id` string
    - `source_local_id` string
    - `source_url` string, nullable
    - `record_type` 'violation' | 'clerk_document'
    - `event_subtype` string, nullable
    - `status` string, nullable
    - `address_raw` string, nullable
    - `city` string, nullable
    - `state` string, nullable
    - `postal_code` string, nullable
    - `description` string, nullable
    - `subject` string, nullable: Best display target: violation address, or lien debtor/owner when no address exists.
    - `detail` string, nullable: Compact display detail for the dashboard.
    - `signal_label` 'Violation' | 'Lien signal' | 'Planning application'
    - `signal_class` 'violation' | 'lien' | 'planning'
    - `is_weak` boolean: True for rows hidden from the default product view unless include_weak=1 is passed.
    - `date` string, date-time, nullable
    - `party_1` string, nullable: Grantor / creditor (clerk docs)
    - `party_2` string, nullable: Grantee / debtor (clerk docs)
    - `consideration` string, nullable: Dollar amount when the source exposes one.
  - `total` integer

## Other responses

- `401`: Missing or invalid API key
- `403`: Paid account required

---

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