How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

OS NGD API - Tiles

OGC API - Tiles conformant vector tile service over the OS National Geographic Database, including tile matrix sets and styles. The OpenAPI 3.0.1 description is served live and anonymously at /api.

OS NGD API - Tiles is one of 12 APIs that Ordnance Survey publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Tiles, OGC API, Vector Tiles, and Mapping. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 13 operations across 13 paths, organized into 6 resource areas, and defines 32 schemas. It is described by OpenAPI 3.0.1, at version v1.8.

Requests are made against a single base URL, https://api.os.uk/maps/vector/ngd/ota/v1.

13 operations 13 paths 32 schemas 13 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
v1.8
Base URL
https://api.os.uk/maps/vector/ngd/ota/v1
Authentication
API Key, API Key, OAuth 2.0
Resource Areas
6

Authentication & Security 3

OS NGD API - Tiles declares 3 security schemes for authenticating requests. An API key is passed in the query as key (api-key). An API key is passed in the header as key (api-key-header). It supports OAuth 2.0 (oauth2) using the clientCredentials flow.

Paths & Operations 13

Across 13 paths, the API surfaces 13 operations — 13 GET. They span 6 resource areas: Landing Page, Data Collections, Tiling Schemes, Tile Sets, Vector Tiles, Styles. Each is listed below with its method, path, parameters, and response codes.

Landing Page 2
GET
/
Retrieve the OS NGD API – Tiles landing page for this service.
getLandingPage → 200400404405406500504
GET
/conformance
Retrieve the set of OS NGD API – Tiles conformance classes that are supported by this service.
getConformance → 200400404405406500504
Data Collections 2
GET
/collections
Retrieve the list of geospatial data collections available from this service.
getCollectionsList → 200400404405406500504
GET
/collections/{collectionId}
Retrieve the description of a collection available from this service.
getCollection 1 param → 200400404405406500504
Tiling Schemes 2
GET
/tilematrixsets
Retrieve the list of available tiling schemes (tile matrix sets)
getTileMatrixSetsList → 200400404405406500504
GET
/tilematrixsets/{tileMatrixSetId}
Retrieve the definition of the specified tiling scheme (tile matrix set)
getTileMatrixSet 1 param → 200400404405406500504
Tile Sets 2
GET
/collections/{collectionId}/tiles
Retrieve a list of available vector tilesets for the specified collection.
.collection.vector.getTileSetsList 1 param → 200400404405406500504
GET
/collections/{collectionId}/tiles/{tileMatrixSetId}
Retrieve the vector tileset metadata for the specified collection and tiling scheme (tile matrix set)
.collection.vector.getTileSet 2 params → 200400404405406500504
Vector Tiles 2
GET
/collections/{collectionId}/tiles/{tileMatrixSetId}/{tileMatrix}/{tileRow}/{tileCol}
Retrieve a vector tile from a collection.
.collection.vector.getTile 5 params → 200400404405406500504
GET
/collections/{collectionId}/tiles/{tileMatrix}/{tileRow}/{tileCol}
Retrieve a vector tile from a collection for Web Mercator Quad EPSG: 3857 tile matrix set.
3857.collection.vector.getTile 4 params → 200400404405406500504
Styles 3
GET
/collections/{collectionId}/styles
Retrieve the list of styles available from this service.
getStylesList 1 param → 200400404405406500504
GET
/collections/{collectionId}/styles/{styleId}
Root level properties of a style specify the map's layers, tile sources and other resources, and default values for the initial camera position when not specified elsewhere.
getStyleRoot 2 params → 200400404405406500504
GET
/collections/{collectionId}/styles/{styleId}/{resourceBaseName}/**
Styling resources such as fonts and sprites
getStyleResources 3 params → 200400404405406500504

Schemas 32

The contract defines 32 schemas that model the data the API accepts and returns. The most detailed are tileMatrix (9 properties), exceptionDto (8 properties), link (8 properties), exception (8 properties). Each schema is shown below with its type and property counts.

confClasses
object
1 property 1 required
link
object
8 properties 2 required
landingPage
object
4 properties 1 required
exception
object
JSON schema for exceptions based on RFC 7807
8 properties 1 required
collections
object
2 properties 2 required
collectionInfo
object
5 properties 2 required
extent
object
The extent of the data in the collection. In the Core only spatial and temporal extents are specified. Extensions may add additional members to represent other…
1 property
extent-uad
The extent module only addresses spatial and temporal extents. This module extends extent by specifying how intervals and crs properties can be used to specify…
crs
string
Reference to one coordinate reference system (CRS)
DataType
string
Type of data
tileSet
object
A resource describing a tileset based on the OGC TileSet Metadata Standard. At least one of the 'TileMatrixSet', or a link with 'rel' http://www.opengis.net/de…
4 properties 3 required
tileSet-item
object
A minimal tileset element for use within a list of tilesets linking to full description of those tilesets.
6 properties 3 required
tileMatrixSet
object
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…
7 properties 2 required
tileMatrixSet-item
object
A minimal tile matrix set element for use within a list of tile matrix sets linking to a full definition.
5 properties 1 required
tileMatrixLimits
object
The limits for an individual tile matrix of a TileSet's TileMatrixSet, as defined in the OGC 2D TileMatrixSet and TileSet Metadata Standard
5 properties 5 required
BoundingBox2D
object
Minimum bounding rectangle surrounding a 2D resource in the CRS indicated elsewhere
3 properties 2 required
style-item
object
3 properties 2 required
exceptionDto
object
JSON schema for exceptions based on RFC 7807
8 properties 1 required
AllCollections
string
TileMatrixSets
string
TileSets
string
Styles
string
geospatialData
object
7 properties 2 required
tileMatrix
object
A tile matrix, usually corresponding to a particular zoom level of a TileMatrixSet.
9 properties 8 required
propertiesSchema
object
Attributes of the features or rangetypes of a coverage. Defined by a subset of the JSON Schema for the properties of a feature
2 properties 2 required
getConformance_200_response
getTileMatrixSetsList_200_response
object
1 property
_collection_vector_getTileSetsList_200_response
object
2 properties 1 required
getStylesList_200_response
object
2 properties 1 required
extent_spatial
object
The spatial extent of the data in the collection.
2 properties
geospatialData_propertiesSchema
propertiesSchema_properties_value
object
No property names are defined but any property name they should be described by JSON Schema. So 'additionalProperties' implements 'name'.
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

ordnance-survey-ngd-tiles-openapi.json Raw ↑

Other APIs Ordnance Survey publishes across the network.

OS NGD API - Features
OS Downloads API
OS Net API
OS Places API
OS Names API
OS Linked Identifiers API
OS Match & Cleanse API (withdrawn)
OS Features API
OS Maps API
OS Vector Tile API
OS OAuth 2 API
Where this information came from

This is an independent, third-party profile of OS NGD API - Tiles, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.