Technical specification

This technical specification explains the content of the OS Names API and the methods you can use to call it.

This technical specification extends the Infrastructure for Spatial Information in the European Community (INSPIRE) Geographical Names theme to ensure compliance with European open data initiatives.

If you are not familiar with the OS Names API please read the overview documentation before proceeding.

Core concepts

This specification does not cover core concepts that apply to all Ordnance Survey APIs.

Please read the following pages to learn more about OS API core concepts:

• Authentication

• Error codes

• Rate-limiting policy

API reference

The OS Names API is an API, which returns queries to the service in either XML or JSON. The service offers two resources:

Find

Return matched features based on a free text search.

Nearest

Return the closest features to a pair of coordinates (X and Y).