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/v_beta/planning/planning-authorities?apikey=YOUR_KEY_HERE'

Example request using request header

curl https://api.landinsight.io/v_beta/planning/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 license is this data under?

License information will be available soon. There will be options for non-commercial and commercial use. Currently the data is for trial purposes only.

What is the pricing?

Pricing depends on 1) if use is commercial or non-commercial 2) if the app is publicly available 3) amount of use 4) if location coordinates are used. Further details will be announced in December.

Will there be a free service?

Yes, a non-commercial license will be available. Further details will be announced in December.

What is your data coverage?

We currently have over 200 councils live on the API across England. 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.