---
title: "Get sanction tallies"
method: GET
path: "/sanctions/tallies"
tags: ["Sanctions"]
---

# Get sanction tallies

`GET /sanctions/tallies`

**Requires permission:** *SanctionsAccess*

Aggregated sanction tally counts for the sanctions grid, scoped to the caller's permissions.

## Query parameters

- `permissionName` string, nullable
- `staffNameId` integer, nullable
- `studentNameId` integer, nullable
- `studentYear` integer, nullable
- `searchQuery` string, nullable
- `houseCodes` string[], nullable
- `subjectIds` integer[], nullable
- `sanctionTypeId` integer, nullable
- `attendance` 0 | 1 | 2
- `category` 0 | 1 | 2
- `boardingSanctionType` boolean, nullable
- `daySanctionType` boolean, nullable
- `fromDate` string, date-time, nullable
- `toDate` string, date-time, nullable
- `pageSize` integer, nullable
- `pageNumber` integer, nullable

## Response `200`

Success - tallies returned

- GetSanctionTalliesResponse
  - `tallies` SanctionTallyDto[]
    - `student` SanctionStudentDto
      - `nameId` integer
      - `studentUpi` string, guid, nullable
      - `pupilId` integer
      - `preferredName` string, nullable
      - `surname` string, nullable
      - `house` string, nullable
      - `seniorHouse` string, nullable
      - `form` string, nullable
      - `emailAddress` string, nullable
      - `boarder` boolean
      - `leaver` boolean
    - `sanctionTypeCounts` object

## Other responses

- `400` — An error occurred - could not get tallies
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/tonbridge/apis/tonbridge-app-api.md) · [All operations](https://skmtc.net/tonbridge/apis/tonbridge-app-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tonbridge/tonbridge-app-api/versions/fab57bf5558a/schema)