Deadlines

The Deadlines API manages legal deadlines (Fristen) and calendar events. German legal practice requires strict deadline management with dual-control verification, Vorfrist/Hauptfrist/Nachfrist chains, and DAV-conforming Fristenbuch exports.

Endpoints

Method	Path	Description
GET	/api/v1/deadlines	List upcoming deadlines
POST	/api/v1/deadlines	Create a deadline
GET	/api/v1/deadlines/{id}	Get a deadline
DELETE	/api/v1/deadlines/{id}	Delete a deadline
GET	/api/v1/deadlines/{id}/chain	Get Vorfrist/Hauptfrist/Nachfrist chain
POST	/api/v1/deadlines/{id}/verify	Verify a deadline (dual-control)
POST	/api/v1/deadlines/{id}/delegate	Delegate verification
GET	/api/v1/deadlines/unverified	List unverified deadlines
GET	/api/v1/events	List calendar events
POST	/api/v1/events	Create a calendar event
PATCH	/api/v1/events/{id}	Update an event
DELETE	/api/v1/events/{id}	Delete an event

The Deadline Object

{
  "id": "evt_01ABCDEFG",
  "type": "frist",
  "title": "Response to Court Filing",
  "case_id": "550e8400-e29b-41d4-a716-446655440000",
  "frist_type": "hauptfrist",
  "due_at": "2026-06-15T23:59:00Z",
  "status": "pending",
  "verified_by": null,
  "assigned_to": "usr_01GHIJKL",
  "chain": {
    "vorfrist": "evt_01VORFRIST",
    "hauptfrist": "evt_01ABCDEFG",
    "nachfrist": null
  },
  "created_at": "2026-05-20T10:00:00Z"
}

Create a Deadline

POST /api/v1/deadlines

Request Body

{
  "title": "Response to Court Filing",
  "case_id": "550e8400-e29b-41d4-a716-446655440000",
  "due_at": "2026-06-15T23:59:00Z",
  "frist_type": "hauptfrist",
  "assigned_to": "usr_01GHIJKL",
  "create_vorfrist": true,
  "vorfrist_days": 3
}

Setting create_vorfrist: true automatically creates a Vorfrist (pre-deadline reminder) the specified number of days before the Hauptfrist.

Dual-Control Verification

Legal deadlines in Germany require dual-control verification (Vier-Augen-Prinzip). After a deadline is created:

1. The deadline appears in the unverified list
2. A second authorized user verifies it via POST /api/v1/deadlines/{id}/verify
3. The verified_by field is populated with the verifier's user ID

Deadline Chain

GET /api/v1/deadlines/{id}/chain returns the full chain of related deadlines:

{
  "vorfrist": {
    "id": "evt_vor_01",
    "due_at": "2026-06-12T23:59:00Z",
    "title": "Vorfrist: Response to Court Filing"
  },
  "hauptfrist": {
    "id": "evt_01ABCDEFG",
    "due_at": "2026-06-15T23:59:00Z",
    "title": "Response to Court Filing"
  },
  "nachfrist": null
}

Next Steps

• Cases -- Link deadlines to cases
• Calendar -- Calendar events and scheduling