---
title: "Get Alert Runs"
method: GET
path: "/alerts/runs/{alert_id}"
tags: ["Alerts"]
---

# Get Alert Runs

`GET /alerts/runs/{alert_id}`

## Request

- Base URL: `https://api.lexmachina.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.lexmachina.com/alerts/runs/{alert_id}`
- Auth: HTTP bearer

Gets a list of all runs an alert has new data for.

- **alert_id**: the id of the alert

Each run represents a new set of relevant items that have been found by the alert on a given day.

## Path parameters

- `alert_id` integer, required

## Response `200`

Success

- AlertRunData
  - `alertId` integer, required
  - `type` string, required
  - `runs` object, required

## Other responses

- `401`: Invalid or expired token
- `404`: Not found
- `422`: Error - 422

## Changes

- **2026-07-13** `8485408d6fea`: 1 info
  - added 'propertyNames' constraint to the `runs` response property for the status `200`

[Operation history](https://skmtc.dev/lexmachina/apis/lex-machina-api/changes/alerts/runs/:alert_id/get.md)

---

[API](https://skmtc.dev/lexmachina/apis/lex-machina-api.md) - [All operations](https://skmtc.dev/lexmachina/apis/lex-machina-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lexmachina/apis/lex-machina-api/revisions/9ebaec5d3551?raw)