Reminder Evaluation Service

Evaluate whether an assignment is due for a reminder or escalation

{
  "assignment_id": "asgn_001",
  "last_contact_date": "2026-03-10T14:30:00Z",
  "last_reminder_sent_at": "2026-03-18T08:00:00Z",
  "org_id": "org_03"
}

{
  "assignment_id": "asgn_001",
  "days_since_contact": 16,
  "reminder_threshold": 14,
  "escalation_threshold": 21,
  "reminder_due": true,
  "escalation_due": false,
  "recommendation": "dispatch_reminder",
  "evaluated_at": "2026-03-26T10:26:00Z"
}

Evaluate multiple assignments in a single call

{
  "org_id": "org_03",
  "assignment_ids": [
    "asgn_001",
    "asgn_002",
    "asgn_007"
  ]
}

{
  "results": [
    {
      "assignment_id": "asgn_001",
      "days_since_contact": 16,
      "reminder_due": true,
      "escalation_due": false,
      "recommendation": "dispatch_reminder"
    },
    {
      "assignment_id": "asgn_002",
      "days_since_contact": null,
      "reminder_due": false,
      "escalation_due": false,
      "recommendation": "none"
    },
    {
      "assignment_id": "asgn_007",
      "days_since_contact": 28,
      "reminder_due": true,
      "escalation_due": true,
      "recommendation": "dispatch_escalation"
    }
  ],
  "evaluated_at": "2026-03-26T10:26:05Z"
}

Get current evaluation thresholds for an organisation

{
  "org_id": "org_03",
  "reminder_days": 14,
  "escalation_days": 21,
  "source": "org_config"
}

{
  "contract_summary": {
    "total_contracts": 410,
    "total_endpoints": 2416,
    "api_styles_used": [
      "rest"
    ]
  },
  "generated_at": "2026-03-26T06:55:53.316Z"
}