Runframe
API Reference

On-Call

Runframe V1 on-call API. Discover who is currently on call for your organization or a team.

Use this endpoint to resolve the current on-call responder before escalating or paging manually.


Get Current On-Call

GET /api/v1/on-call/current
ParameterTypeDescription
team_namestringOptional team name filter (case-insensitive)

Response:

{
  "success": true,
  "data": {
    "timestamp": "2026-04-19T12:30:00.000Z",
    "summary": {
      "total_services": 12,
      "services_with_coverage": 10,
      "services_without_coverage": 2,
      "coverage_percentage": 83
    },
    "services": [
      {
        "service_key": "svc_K7M4Q9TZ2H",
        "service_name": "Payments API",
        "service_description": null,
        "team_name": "Platform",
        "team_description": null,
        "on_call_engineers": [
          {
            "name": "Jane Doe",
            "email": "jane@runframe.io",
            "slack_user_id": "U123456",
            "role": "primary",
            "schedule_name": "Platform Primary",
            "shift_starts_at": "2026-04-19T09:00:00.000Z",
            "shift_ends_at": "2026-04-19T17:00:00.000Z"
          }
        ],
        "has_coverage": true,
        "primary_on_call": {
          "name": "Jane Doe",
          "email": "jane@runframe.io",
          "slack_user_id": "U123456",
          "role": "primary",
          "schedule_name": "Platform Primary",
          "shift_starts_at": "2026-04-19T09:00:00.000Z",
          "shift_ends_at": "2026-04-19T17:00:00.000Z"
        },
        "schedule_names": ["Platform Primary"]
      }
    ]
  }
}

data.summary gives organization-level coverage totals. data.services lists the current on-call coverage for each service, including the assigned engineers, primary responder, and backing schedules.

If you pass team_name, the response is limited to services covered by that team's schedules.