Getting started

Before you start using the API, you’ll need an API Key. Register to request one.

To understand what the API can do, see the full API documentation.

Want to try a demo project? Try the simple Google Maps demo.

Once you have your API key, read on below to connect to the API for the first time.

Authentication

Try the interactive Console. Select an action, press 'Switch to Console', click the Headers tab, paste your API key in the relevant box, change 'Mock server' to 'Production' then press 'Try' to send the request.

To connect via the command line, you can authenticate by providing your secret API key in the query string or request headers.

Example request using query string

curl 'https://api.landinsight.io/v1/planning-authorities?apikey=YOUR_KEY_HERE'

Example request using request header

curl https://api.landinsight.io/v1/planning-authorities -H 'X-Api-Key: YOUR_KEY_HERE'

Take note of the single quote marks, missing them will result in a 401 Unauthorized response.

Handling Errors

The API uses standard HTTP REST codes to respond to errors.

401 Unauthorised. Check your API key.
404 File not found. Check the URL is correct. Check the item code exists.
500 Internal server error. Please report any API errors.

FAQs

What is the pricing?

Please contact us for further information.

What is your data coverage?

We currently have over 320 councils live on the API across England and Wales. To check if your area is covered, view the planning history map in Land Insight or check via the API.

My council isn't covered. When will it be available?

Drop us an email with the areas you want covered. Priority is given to paying customers.

How do I check my API usage and limits?

Check using the API. See the API Reference

I've hit my monthly limit. What do I do?

Send us an email to increase your limit.