📅 Deadlines API

Manage deadlines, due dates, and tasks for cases. Track court deadlines, hearings, and internal tasks.

Deadline Object

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "title": "File response to motion",
  "dueDate": "2026-02-15T17:00:00Z",
  "caseId": "case-uuid-here",
  "assignedUserId": "user-uuid-here",
  "completedAt": null,
  "firmId": "firm-uuid-here",
  "createdAt": "2026-01-15T10:00:00Z"
}

Fields

FieldTypeDescription
idstringUnique identifier (UUID)
titlestringDeadline description
dueDatedatetimeWhen the deadline is due (ISO 8601)
caseIdstringAssociated case ID
assignedUserIdstringUser responsible
completedAtdatetimeWhen completed (null if pending)

List Deadlines

GET /api/deadlines

Query Parameters

ParameterTypeDescription
caseIdstringFilter by case ID
completedbooleanFilter by completion status

Example

GET /api/deadlines?completed=false

Response:
{
  "success": true,
  "data": [
    {
      "id": "...",
      "title": "Submit evidence",
      "dueDate": "2026-02-01T17:00:00Z",
      "completedAt": null,
      ...
    }
  ]
}

Get Deadline

GET /api/deadlines/{id}

Create Deadline

POST /api/deadlines

Request Body

{
  "title": "Court hearing",
  "dueDate": "2026-03-15T10:00:00Z",
  "caseId": "case-uuid-here",
  "assignedUserId": "user-uuid-here"
}

Update Deadline

PUT /api/deadlines/{id}

Request Body

{
  "title": "Court hearing - Rescheduled",
  "dueDate": "2026-03-22T10:00:00Z",
  "assignedUserId": "user-uuid-here"
}

Mark as Complete

POST /api/deadlines/{id}/complete

Marks the deadline as completed with the current timestamp.

Response

{
  "success": true,
  "data": {
    "id": "...",
    "completedAt": "2026-01-15T14:30:00Z",
    ...
  }
}

Delete Deadline

DELETE /api/deadlines/{id}

Get Overdue Deadlines

GET /api/deadlines/overdue

Returns all deadlines that are past their due date and not completed.

Response

{
  "success": true,
  "data": [
    {
      "id": "...",
      "title": "Overdue task",
      "dueDate": "2026-01-10T17:00:00Z",
      "completedAt": null,
      ...
    }
  ]
}

← Back to API Overview