---
title: "Get a report template + its parsed structure"
method: GET
path: "/reports/templates/{id}"
tags: ["Reports"]
---

# Get a report template + its parsed structure

`GET /reports/templates/{id}`

**Requires permission:** *ReportAdmins*

Returns a single template and its deserialised structure (steps, mark-grade fields/options, step group selections and report info HTML) so the report-setup flow can pre-fill a new report.

## Path parameters

- `id` integer, required

## Response `200`

Success - Template

- GetReportTemplateResponse
  - `template` ReportTemplateSummary
    - `id` integer
    - `name` string, nullable
    - `academicYear` integer, nullable
    - `yearGroup` string, nullable
    - `createdBy` string, nullable
    - `createdDate` string, date-time
  - `structure` ReportTemplateStructure
    - `yearGroup` string, nullable
    - `sportAllocation` boolean
    - `hidden` boolean
    - `htmlTop` string, nullable
    - `htmlBottom` string, nullable
    - `steps` ReportTemplateStep[]
      - `number` integer
      - `overwriteName` string, nullable
      - `reportOrder` integer, nullable
      - `hidden` boolean
      - `musicReports` boolean
      - `enableAiChecker` boolean
      - `stepType` integer, nullable
      - `groupSelectionsJson` string, nullable
      - `markGradeForms` ReportTemplateGradeField[]
        - `name` string, nullable
        - `hidden` boolean
        - `type` integer
        - `assessment` boolean
        - `options` ReportTemplateGradeOption[]
          - `displayName` string, nullable
          - `value` string, nullable
          - `allowText` boolean

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found - Template does not exist

---

[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)
