---
title: "Get a sheet's mapping"
method: GET
path: "/v1/sheets/{sheet_id}/mapping"
tags: ["Sheets"]
---

# Get a sheet's mapping

`GET /v1/sheets/{sheet_id}/mapping`

Retrieve the current mapping of the sheet's columns to the template's columns.

## Path parameters

- `sheet_id` integer, required

## Query parameters

- `embed_id` integer

## Response `200`

The request has succeeded.

- SheetMapping
  - `template_key` string, nullable — The unique key of the template assigned to the sheet, if any.
  - `sheet_columns` MappingSheetColumn[] — The sheet columns and their current template mappings.
    - `id` integer, required — The unique identifier of the sheet column.
    - `template_column_key` string, nullable — The key of the template column this sheet column is mapped to, if any.
  - `template_columns` MappingTemplateColumn[] — The template columns and the sheet columns mapped to each one.
    - `key` string, required — The key of the template column.
    - `mapped_to` integer[] — The ids of the sheet columns mapped to this template column.

## Other responses

- `400` — 400

---

[API](https://skmtc.net/oneschema/apis/templates.md) · [All operations](https://skmtc.net/oneschema/apis/templates/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oneschema/templates/versions/40674aa6d4d9/schema)