---
title: "Subscribe to case-activity alerts"
method: POST
path: "/api/subscribe"
---

# Subscribe to case-activity alerts

`POST /api/subscribe`

## Request

- Base URL: `https://app.courtdelta.com`
- URL: `https://app.courtdelta.com/api/subscribe`
- Auth: none required

Starts monitoring a case for the given person; sends email (and optional SMS) when the case has new activity. With requireConfirmation=true the signup is created PENDING and only a confirmation email is sent — no monitoring begins, and no attorney lead is created, until the emailed link is confirmed via /api/subscribe/confirm.

## Request body

- object
  - `name` string, required
  - `email` string, email, required
  - `caseNumber` string, required
  - `phone` string: Optional 10-digit US phone for SMS alerts.
  - `requireConfirmation` boolean: Double opt-in. Required for any caller that cannot prove the submitter owns the email address (e.g. an AI assistant). Creates the row inactive with a single-use confirmation token, sends one confirmation email, and skips attorney lead sharing. Repeat calls while a confirmation is outstanding send nothing.

## Response `200`

Subscribed, or (requireConfirmation) status='pending_confirmation'

## Other responses

- `400`: Validation error
- `403`: Free plan limit of 2 active cases per email
- `409`: Already monitoring this case

---

[API](https://skmtc.dev/courtdelta/apis/court-delta-public-api.md) · [All operations](https://skmtc.dev/courtdelta/apis/court-delta-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/courtdelta/apis/court-delta-public-api/revisions/813e5b14be89?raw)