---
title: "Get aggregated on-call hours for a date range"
method: GET
path: "/api/public/v1/on-call-report/sum"
tags: ["OnCallReport"]
---

# Get aggregated on-call hours for a date range

`GET /api/public/v1/on-call-report/sum`

## Request

- Base URL: `https://allquiet.app` (the document declares no server; this is the origin it was published from)
- URL: `https://allquiet.app/api/public/v1/on-call-report/sum`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/allquiet/apis/all-quiet-public-api/docs/api/public/v1/on-call-report/sum/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns total on-call duration per user for the organization between the requested start and end dates. Optionally filter by user ID, team ID, or max escalation tier.

**Required API key permissions**

- **Scope:** `on-call-report:get`
- **Accepted key types:** organization API key (org-wide), personal access token (org-wide)
- **Access:** Operates on a single organization. Pass organizationId when your API key spans multiple organizations.
- **Required organization role (user-linked keys only):** Administrator
- Organization API keys are not subject to organization or team role checks.
- **Notes:** Results for team-restricted personal access tokens are filtered to their teams.

## Query parameters

- `Start` string, date-time, required
- `End` string, date-time, required
- `UserId` string, uuid
- `TeamId` string, uuid
- `MaxTier` integer
- `organizationId` string, uuid

## Response `200`

OK

- AllQuietApiPublicOnCallReportOnCallReportSumResponse
  - `userSums` AllQuietApiPublicOnCallReportOnCallReportUserSumResponse[], nullable, required
    - `user` AllQuietApiPublicOnCallReportOnCallReportUserResponse, required
      - `id` string, uuid, required
      - `displayName` string, nullable
      - `email` string, nullable
      - `userName` string, nullable
      - `timeZoneId` string, nullable
    - `netOnCallMinutes` integer, required

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/allquiet/apis/all-quiet-public-api.md) - [All operations](https://skmtc.dev/allquiet/apis/all-quiet-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/allquiet/apis/all-quiet-public-api/revisions/bd7da0475359?raw)