Overview

This web service enables you to absorb Postcode lookups into you app.

Both REST and SOAP services allow you to switch the period used for the data. Currently, the following datasets are available:

• 2010 - <service url>/2010
• 2014 - <service url>/2014
• Latest - <service url>/latest (This is just an alias and is the default)

REST

http:/sws.substance.net/ons/rest

This service will return a json encoded array will all in the information about the requested postcode. If an incomplete postcode if reqested, a summary of the matches will be returned.

Parameters

• postcode - full or part postcode

REST

http:/sws.substance.net/ons/rest/getcodename

This method enables to the lookup of various code

Parameters

• type - One of the following values:
  • ladcua
  • pct
  • ward
  • gor
  • county
• code - The code to look up

REST

http:/sws.substance.net/ons/rest/convertwardto2012

Ward code formats changed in 2012, this method allows you to convert the current format to the pre 2012 format.

Parameters

• code - The ward code to look up

SOAP

http:/sws.substance.net/ons/soap

The following methods are available via the SOAP web service:

• getWardBasic - This returns basic information about the postcode
• getWardInformation - This returns the full information about the postcode
• getCodeName - This method enables to the lookup of various code
• convertWardTo2012 - Ward code formats changed in 2012, this method allows you to convert the current format to the pre 2012 format.

Further information about these methods can be found here.