Reminder Dispatch Service
API Contract
REST
/api/v1/reminder-dispatch
3 endpoints
POST
/api/v1/reminder-dispatch/api/v1/reminder-dispatch/reminder
Dispatch a reminder notification to the peer mentor for an assignment
Public
Request Example
{
"assignment_id": "asgn_001",
"peer_mentor_id": "user_042",
"org_id": "org_03"
}
Response Example
{
"dispatched": true,
"assignment_id": "asgn_001",
"recipient_id": "user_042",
"notification_type": "reminder",
"push_delivery": "delivered",
"in_app_created": true,
"dispatched_at": "2026-03-26T10:21:00Z"
}
POST
/api/v1/reminder-dispatch/api/v1/reminder-dispatch/escalation
Dispatch an escalation notification to the coordinator
Public
Request Example
{
"assignment_id": "asgn_007",
"coordinator_id": "user_007",
"peer_mentor_id": "user_033",
"org_id": "org_03"
}
Response Example
{
"dispatched": true,
"assignment_id": "asgn_007",
"recipient_id": "user_007",
"notification_type": "escalation",
"push_delivery": "delivered",
"in_app_created": true,
"dispatched_at": "2026-03-26T10:21:05Z"
}
GET
/api/v1/reminder-dispatch/api/v1/reminder-dispatch/history
List dispatch history for all assignments
Public
Response Example
{
"data": [
{
"dispatch_id": "disp_441",
"assignment_id": "asgn_001",
"notification_type": "reminder",
"recipient_id": "user_042",
"dispatched_at": "2026-03-18T08:00:00Z",
"delivery_status": "delivered"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 18
}
}