---
title: "Get the list of reports for a student"
method: GET
path: "/reports/viewer"
tags: ["Reports"]
---

# Get the list of reports for a student

`GET /reports/viewer`

**Requires permissions:** *Guardian* or *Leaver* or *Parent* or *StaffMember* or *Student*

Returns the distinct reports a pupil has entries in, with publish flags. Staff may pass any NameId; a student/leaver or parent/guardian is scoped to themselves / their child. Unpublished reports gain a 'Published on ...' suffix for the non-staff audience. Leaver self-view is in the FR-019 in-scope set.

## Query parameters

- `nameId` integer, nullable

## Response `200`

Success - Retrieved reports

- GetReportListResponse
  - `reports` ReportListItemDto[]
    - `description` string, nullable
    - `pupilName` string, nullable
    - `id` integer, nullable
    - `year` integer, nullable
    - `publishDate` string, date-time
    - `studentPublishDate` string, date-time
    - `published` boolean
    - `studentPublished` boolean
    - `hidden` boolean
  - `nameId` integer
  - `staff` boolean
  - `student` boolean
  - `parent` boolean

## Other responses

- `400` — An Error Occurred - Could not get reports
- `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/28344aa564b4/schema)