Support

How to Contact Us

We provide a couple of avenues to contact us, however please keep in mind our response hours when waiting for a response.

email
Twitter Support

We are available to follow and contact via our Twitter account @OpenPostcodes

email
Email Support

Send an email to our support team, better for in-depth communication support@openpostcodes.com

clock
Response Hours

Monday-Friday: 9am - 4pm (London)
Saturday-Sunday: closed
UK Bank Holidays: closed


Frequently Asked Questions

Getting Started


How do I get started?

The best way to understand our API we refer your to the documentation and try out the API for yourself using our testing key and postcodes. We also provide examples of the API implementation in different programming languages and maintain fully open source libraries to aid you with integration into your own application.

How do I purchase postcode lookups?

Postcode lookups can be purchased from your account area. Each key has its own individual lookup count and can hold either a public or private lookup licence. We accept Visa, MasterCard and American Express.

How do I ensure I have sufficient lookups remaining?

We provide email notifications to alert you when you are running low on lookups, this is activated on a per API key basis. You can set varying thresholds and multiple notification email addresses per key from your account area.

Do you provide free data?

Yes. We provide geographical postcode data completely free of charge, no lookups will be used, all you need is an API key. For more information see our documentation regarding location data.

I am still puzzled!

If you require additional help please contact our support department with your query. If your postcode lookup implementation is public facing i.e. on a website, we can even help you debug your code.

Billing


PCI and Payment Security

All Open Postcodes payments are managed by Stripe. Stripe holds the highest most stringent level of PCI certificate, Level 1 Service Provider. Open Postcodes servers never hold or 'see' any card information, this is all handled by Stripe.

How do I purchase postcode lookups?

Postcode lookups can be purchased from your account area. Each key has its own individual lookup count and can hold either a public or private lookup licence. We accept Visa, MasterCard and American Express.

Do my lookups ever expire?

No. Lookups are never removed from your balance unless you use them.

Usage Policy


What are Public Lookups?

Public lookups are used for application which are publicly available, such as websites or applications, where a postcode will be entered by a customer. For example a website or application which is avaliable to the customer to register, enter their delivery information, etc.

What are Private Lookups?

Private lookups are used for applications which are only available for private use i.e. within an organisation or company. For example when postcodes will be entered by staff members, you or specific users and not for public use.

Account


How do I update my account details?

This can be done from your account area. Simply sign in, and click "Edit Account" on the right-hand side. You can change all of the information associated with your account.

I forgot my account password

If you forget your account password you can have it reset using the forgot password form. This will allow you to create a new account password after clicking the verification link on the forgot password email.

API


Is there an unencrypted HTTP option available for the API?

No. We only provide a HTTPS API, any plain-text HTTP connection is rejected

Do you provide any alternative API response formats?

Currently we only provide responses in JSON format, however we may consider additional formats in the future. Contact support if you require a particular format.

What is a "Lookups Exhausted" error?

This error means the API key you are using has 0 postcode lookups remaining. In order to continue requesting data you must purchase more lookups for that key, from your account area.

The API returned an response code which indicated an error (not 200)

For in-depth information about response codes and error messages check out the response codes section in the documentation. If you are still having problems, contact support.

What if my API key is visible to the customer or user?

In order to prevent key abuse we provide a range of measures to protect your key. Daily Lookup Limit, to ensure only a set number of lookups can be used on daily basis. Daily IP Lookup Limit, to ensure a single client can only perform a set number of lookups on a daily basis. Allowed URLs, only processes requests from a list of prediterminded URLs supplied for each key.

Why is location data missing from a few addresses?

The address is new and is currently not included on the Ordnance Survey's Database or the address is a POBox.

What if the API structure changes?

Major API versions will never change structure within its minor versions, check out versioning for more information. We also provide optional email notifications when API alterations occur, this setting can be changed in your "Edit Account" settings.