Manage legal deadlines (Fristen), calendar events, and dual-control verification for compliance.

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

Required scope: deadlines:read for GET endpoints, deadlines:write for POST/PUT/DELETE.

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:

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

Unverified deadlines are highlighted in the Fristenbuch and may indicate compliance risk. Verify all deadlines promptly.

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

Deadlines