LogoLogo
OS Docs HomeOS NGDOS APIsOS Download ProductsMore than MapsOS Data Hub
  • Introduction to OS APIs
  • Core Concepts
    • Getting started with an API project
    • Authentication
    • Error codes
    • Rate-limiting policy
    • OS API branding
    • Service level agreements
    • Service availability dashboard
  • Accessing OS APIs
    • OS Maps API
      • Layers and styles
      • Getting started
        • ESRI ArcGIS Online
        • ESRI ArcGIS Pro
        • ESRI ArcMap
        • Cadcorp SIS
        • MapInfo Pro
        • QGIS
      • Technical specification
        • ZXY
        • WMTS
      • Code examples
    • OS Vector Tile API
      • What data is available?
      • Getting started
        • ESRI ArcGIS Pro
        • Cadcorp SIS
        • QGIS
        • Create a web application using the OS Vector Tile API
      • Technical specification
        • Service Metadata
        • Stylesheet
        • Tile request
      • Code examples
      • Stylesheets
    • OS NGD API – Tiles
    • OS NGD API – Features
    • OS Features API
      • OS Product Archive
      • What data is available?
      • Getting started
        • ArcGIS Online
        • ArcGIS Pro
        • ArcMap
        • Cadcorp SIS
        • MapInfo Pro
        • QGIS
      • Technical specification
        • getCapabilities
        • describeFeatureType
        • getFeature
        • Filtering
        • Paging
        • Empty values
      • Code examples
    • OS Names API
      • Getting started with example queries using Node.js
      • Technical specification
        • Find
        • Nearest
      • Code list
      • Code examples
    • OS Linked Identifiers API
      • What data is available?
      • Getting started with implementing a look-up application
      • Technical specification
        • Identifier
        • Identifier Types
        • Feature Types
        • Product Version Information
      • Code examples
    • OS Places API
      • Getting started with example queries using Node.js
      • Technical specification
        • Find
        • Postcode
        • UPRN
        • Nearest
        • BBOX
        • Radius
        • Polygon
      • Datasets
      • Code lists
      • Code examples
    • OS Match & Cleanse API
      • End of Life Information
      • Getting started with an example match query using Node.js
      • Technical specification
      • Datasets
      • Code lists
    • OS Downloads API
      • Getting started
        • Automating OS OpenData downloads
        • Automating OS Premium data downloads
      • Technical specification
        • OpenData products
        • OpenData product details
        • Download an OpenData product
        • OpenData product image
        • Data packages
        • Data package ID
        • Data package version
        • Data package version ID
        • Download a data package
    • OAuth 2 API
      • Getting started
      • Technical specification
  • Additional resources
    • OS API Wrappers
      • JavaScript
      • Python
      • R
  • Extra Links
    • Accessibility
    • Contact us
    • PSGA Product Summary
    • Terms and conditions
Powered by GitBook
On this page
  • Adding an API to a new project
  • Adding an API to an existing project
  • Removing an API from a project
  • Regenerating an API key
  • Deleting a project
  • Finding your API endpoint address

Was this helpful?

  1. Core Concepts

Getting started with an API project

PreviousIntroduction to OS APIsNextAuthentication

Last updated 1 year ago

Was this helpful?

To access any OS APIs, you need an API key and / or API secret token. These credentials are scoped to a dedicated API project that is linked to your OS Data Hub account. You can can find your API Projects and Project API Keys in your API Dashboard where you can fully manage all aspects of your OS APIs.

Adding an API to a new project

Before you can access our OS APIs, you need to add at least one API to a new or existing project in the OS Data Hub and generate an API key.

To add an API to a project and generate an API key:

  1. Log in to your account.

  2. Click API Dashboard in the main menu.

  3. Click APIs in the secondary navigation menu.

  4. Click the Add to API project button of the API you want to add.

  5. In the Add to API project dropdown click Add to NEW PROJECT.

  6. Enter a project name in the dialog and then click Create project.

  7. The <Project Name> page opens and displays the:

    • Project API Key: For example, GCk3L4TFnuKwcwG1PMJBtOyuipu6MOlV

    • Project API Secret: For example, zi7Vbor5f8i2ZTMs

    • Other API-specific information, for example the API endpoint address.

You can return to this page at any point in the future by opening My projects in the secondary navigation menu, if you need to copy your Project API Key or API endpoint address, or Regenerating an API key, for example.

Adding an API to an existing project

  1. In API Dashboard > My Projects.

  2. Click the <project name> link in the list of projects to open the dedicated project page, if necessary.

  3. Click + Add API.

  4. Click Add to API project for the required API and then Done to close the dialog.

  5. The API will be added to the project and will be able to utilise the same Project API key.

Removing an API from a project

  1. In API Dashboard > My Projects.

  2. Click the <Project Name> link in the list of projects to open the dedicated project page, if necessary.

  3. Click Remove from project for the specific API.

  4. Click Remove API from project to confirm the removal.

Regenerating an API key

  1. In API Dashboard > My Projects.

  2. Click the <Project Name> link in the list of projects to open the dedicated project page, if necessary.

  3. Click Actions > Regenerate API key.

  4. Enter the one-time code to confirm your action and then click Regenerate API Key.

Deleting a project

  1. In API Dashboard > My Projects.

  2. Click the <Project Name> link in the list of projects to open the dedicated project page, if necessary.

  3. Click Actions > Delete this project.

  4. Enter the one-time code to confirm your action and then click Permanently remove project.

Finding your API endpoint address

  1. Select API Dashboard from the main menu. You must be logged into the OS Data Hub to view the contents of this tab.

  2. Select My projects from the secondary navigation menu.

  3. Select the project you're interested in.

  4. Your API endpoint address will be displayed in the project information under the OS API that has been added to the project.

Log into your account.

OS Data Hub
OS Data Hub
YouTube video showing how to add OS NGD API – Tiles to a new project on the OS Data Hub and generate an API key.
Example API Dashboard highlighting APIs link in secondary navigation
Example API Dashboard showing Actions > Delete this project button
Example API Dashboard showing the Permanently delete this project and its API key? confirmation dialog
Screenshot of the OS Data Hub Welcome screen highlighting the API Dashboard tab
Example API Dashboard highlighting APIs link in secondary navigation
Screenshot of an example API Dashboard showing the Add to API project button of the OS NGD API - Features
Screenshot of an example API Dashboard showing the Add to NEW PROJECT link of OS NGD API - Features
Screenshot of an example API Dashboard  - Give your project a name dialog
Example API Dashboard showing project page
Example API Dashboard showing Actions and + Add API buttons
Example API Dashboard showing Add API to this project dialog
Example API Dashboard showing project page
Example API Dashboard showing Remove from project button for OS NGD API - Tiles
Example API Dashboard showing Remove OS NGD API - Tiles from this project confirmation dialog
Example API Dashboard showing Actions > Regenerate API Key button
Example API Dashboard showing Regenerate API Key? confirmation dialog
Example API Dashboard showing Actions > Delete this project button
Example API Dashboard showing the Permanently delete this project and its API key? confirmation dialog