---
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}`

## Request

- Base URL: `https://api.os.uk/maps/vector/ngd/ota/v1`
- URL: `https://api.os.uk/maps/vector/ngd/ota/v1/tilematrixsets/{tileMatrixSetId}`
- Auth: none declared

## 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.dev/ordnance-survey/apis/ngd-tiles.md) - [All operations](https://skmtc.dev/ordnance-survey/apis/ngd-tiles/llms.txt) - [OpenAPI document](https://skmtc.dev/ordnance-survey/apis/ngd-tiles/revisions/7f01b91d9389?raw)