To use any LDS web service or API, you will first need to create an API key.

LDS web services start with a key

Your key is a long string of characters unique to your LDS account and allows you to access your LDS account without you having to provide your password.

Only registered users of the LINZ Data Service can create API keys, and all web services providing data require an API key.

Once you have created your key, if you are logged into LDS and select a web service URL, your web service key is automatically populated in the URL for you to easily copy and paste into your application.

Here is an example of an LDS WMTS Get Capabilities URL that has a web services key included:;key=g5eic0047fg38fksamnx5430fbdt5970/wmts/1.0.0/layer/50767/WMTSCapabilities.xml

How to create a LDS API key

  1. Login to LDS and click on your name in the top menu, then click APIs & Web Services to go to the following page:
    Screen shot of LINZ Data Serves API interface
  2. Use the Label field to give your API key a name
  3. Select ‘Data access only’
  4. Accept terms and create key

Find more information about API keys and the services they provides access to at the Koordinates Support site.

Reference Category: Web services
Reference Tags: API key, Token
Last Updated: 
9 June 2020