---
title: "Retrieve the definition of the specified tiling scheme (tile matrix set)"
method: GET
path: "/tilematrixsets/{tileMatrixSetId}"
tags: ["Tiling Schemes"]
---

# Retrieve the definition of the specified tiling scheme (tile matrix set)

`GET /tilematrixsets/{tileMatrixSetId}`

## Path parameters

- `tileMatrixSetId` '3857' | '27700', required

## Response `200`

tile matrix set

- TileMatrixSet — A definition of a tile matrix set following the Tile Matrix Set standard. For tileset metadata, such a description (in `tileMatrixSet` property) is only required for offline use, as an alternative to a link with a `http://www.opengis.net/def/rel/ogc/1.0/tiling-scheme` relation type.
  - `title` string — Title of this tile matrix set, normally used for display to a human
  - `id` string — Tile matrix set identifier. Implementation of 'identifier'
  - `uri` string, uri — Reference to an official source for this tileMatrixSet
  - `orderedAxes` string[]
  - `crs` string, uri, required — Reference to one coordinate reference system (CRS)
  - `wellKnownScaleSet` string, uri — Reference to a well-known scale set
  - `tileMatrices` TileMatrix[], required — Describes scale levels and its tile matrices
    - `id` string, required — Identifier selecting one of the scales defined in the TileMatrixSet and representing the scaleDenominator the tile. Implementation of 'identifier'
    - `scaleDenominator` number, required — Scale denominator of this tile matrix
    - `cellSize` number, required — Cell size of this tile matrix
    - `cornerOfOrigin` 'topLeft' | 'bottomLeft' — The corner of the tile matrix (_topLeft_ or _bottomLeft_) used as the origin for numbering tile rows and columns. This corner is also a corner of the (0, 0) tile.
    - `pointOfOrigin` number[], required — Precise position in CRS coordinates of the corner of origin (e.g. the top-left corner) for this tile matrix. This position is also a corner of the (0, 0) tile. In previous version, this was 'topLeftCorner' and 'cornerOfOrigin' did not exist.
    - `tileWidth` number, required — Width of each tile of this tile matrix in pixels
    - `tileHeight` number, required — Height of each tile of this tile matrix in pixels
    - `matrixHeight` number, required — Width of the matrix (number of tiles in width)
    - `matrixWidth` number, required — Height of the matrix (number of tiles in height)

## Other responses

- `400` — The request was not supported.
- `404` — The requested resource does not exist on the server. For example, a path parameter had an incorrect value.
- `405` — The HTTP method requested is not supported. This endpoint only supports 'GET' requests.
- `406` — A request header value was not supported.
- `500` — A server error occurred.
- `504` — Gateway Timeout.

---

[API](https://skmtc.net/ordnance-survey/apis/ngd-tiles.md) · [All operations](https://skmtc.net/ordnance-survey/apis/ngd-tiles/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ordnance-survey/ngd-tiles/revisions/7f01b91d9389/schema)