---
title: "Import exam results, component marks and basedata"
method: POST
path: "/Exams/Results/Import"
tags: ["Exams"]
---

# Import exam results, component marks and basedata

`POST /Exams/Results/Import`

**Requires permission:** *ExamAdmin*

Accepts whatever the boards sent — JCQ a2c XML, JCQ EDI results, a Cambridge International spreadsheet, or JCQ basedata definition files — one file or several, and saves subject results, component marks and board definitions. Each file's format is detected from its contents, not its name. WorkbookMark chooses the raw, adjusted or weighted column of a spreadsheet; DuplicateHandling decides whether an outcome that already exists is added alongside or replaced; DryRun reports what would happen and writes nothing.

## Query parameters

- `page` integer, required
- `pageSize` integer, required
- `includes` string[], nullable
- `sort` string, nullable
- `filter` string, nullable

## Response `200`

Success - Imported

- PostImportComponentMarksResponse
  - `componentMarks` PassExamComponentMark[]
    - `id` integer
    - `candidateNumber` integer
    - `componentId` string
    - `componentMark` string
    - `year` integer
    - `type` string
  - `files` PostImportComponentMarksFileSummary[]
    - `fileName` string, nullable
    - `format` string, nullable
    - `marks` integer
  - `format` string, nullable
  - `dryRun` boolean
  - `inserted` integer
  - `updated` integer
  - `existingDuplicates` integer
  - `duplicatesWithinUpload` integer
  - `results` integer
  - `definitions` integer
  - `distinctComponentCodes` integer
  - `matchedComponentCodes` integer
  - `meta` Meta
    - `page` integer
    - `pageSize` integer
    - `total` integer

## Other responses

- `400` — A file could not be read, or held nothing
- `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/revisions/05c7190a0463/schema)