Extra address information

Extra data fields can be appended to any of the address lookup responses.

Add the ?addtags=[field-names] querystring parameter to your request, with the field names supplied as a comma-separated list.

Lookup cost: There is an additional lookup cost to return some of these fields - see below

Example request & response

Request: http://ws.postcoder.com/pcw/PCW45-12345-12345-1234X/address/uk/NR147PZ?format=json&addtags=localauthorityname,electoralwardname,electoralcountyname - View live response

[
    {
        "summaryline":"Allies Computing Ltd, Manor Farm Barns, Fox Road, Framingham Pigot, Norwich, Norfolk, NR14 7PZ",
        "organisation":"Allies Computing Ltd",
        "buildingname":"Manor Farm Barns",
        "premise":"Manor Farm Barns",
        "street":"Fox Road",
        "dependentlocality":"Framingham Pigot",
        "posttown":"Norwich",
        "county":"Norfolk",
        "postcode":"NR14 7PZ",
        "localauthorityname":"South Norfolk",
        "electoralcountyname":"Norfolk",
        "electoralwardname":"Poringland with the Framinghams"
    }
]

Pricing

Including the addtags parameter with your requests increases the lookup cost as follows:

Endpoint address addressgeo street
Normal Price 2.0 credits 2.4 credits 1.5 credits
Price with addtags 2.4 credits 2.4 credits 1.9 credits

Parameters

Premise-level data fields

Note: there is no additional credit cost to append these fields.

Description Addtags field name Tag name returned in output
Delivery Point Suffix deliverypointsuffix deliverypointsuffix
Unique Delivery Point Reference Number (UDPRN) udprn uniquedeliverypointreferencenumber
Data Origin - has the value ‘P’ for a record extracted solely from PAF® and ‘M’ for one originating from the MR file dataorigin dataorigin
Unique Multiple Residence Reference Number - equivalent to the UDPRN in PAF® data uniquemultipleresidencereferencenumber uniquemultipleresidencereferencenumber
Multiple Occupancy Count - count of the number of multiple occupancy addresses for the delivery point multipleoccupancycount multipleoccupancycount
Multiple Residence Record Count - the actual count of MR records following the PAF® delivery point record multipleresidencerecordcount multipleresidencerecordcount

Street-level data fields

Note: there is no additional credit cost to append these fields.

Description Addtags field name Tag name returned in output
Administrative County (top tier local government) administrativecounty administrativecounty
Former Postal County postalcounty postalcounty
Traditional County traditionalcounty traditionalcounty
User Category (residential 'R', Non-residential 'N', or Large 'L') usercategory usercategory
Sortcode (for Royal Mail Mailsort) sortcode sortcode
Delivery Point Count - number of delivery points in this record deliverypointcount deliverypointcount
Country code (within the United Kingdom) countrycode countrycode
Country name (within the United Kingdom) country country

Welsh language alternative fields

Note: there is no additional credit cost to append these fields.

Description Addtags field name Tag name returned in output
Welsh language alternative for dependent street field welsh_dependentstreet welsh_dependentstreet
Welsh language alternative for street field welsh_street welsh_street
Welsh language alternative for double dependent locality field welsh_doubledependentlocality welsh_doubledependentlocality
Welsh language alternative for dependent locality field welsh_dependentlocality welsh_dependentlocality
Welsh language alternative for post town field welsh_posttown welsh_posttown

2011 Census data fields

Description Addtags field name Tag name returned in output
2011 Census Output Area censusoutputarea_2011 censusoutputarea_2011
2011 Census Output Area classification censusoutputareaclassification_2011 censusoutputareaclassification_2011
2011 Census Lower Layer Super Output Area censuslowerlayersuperoutputarea_2011 censuslowerlayersuperoutputarea_2011
2011 Census Middle Layer Super Output Area censusmiddlelayersuperoutputarea_2011 censusmiddlelayersuperoutputarea_2011
2011 Census Urban/Rural Indicator censusurbanruralindicator_2011 censusurbanruralindicator_2011
2011 Census Workplace Zone censusworkplacezone_2011 censusworkplacezone_2011
2011 Census Built Up Area builtuparea builtuparea
2011 Census Built Up Area sub-division builtupareasubdivision builtupareasubdivision

2001 Census data fields

Description Addtags field name Tag name returned in output
2001 Census Output Area censusoutputarea_2001 censusoutputarea_2001
2001 Census Output Area classification censusoutputareaclassification_2001 censusoutputareaclassification_2001
2001 Census Lower Layer Super Output Area censuslowerlayersuperoutputarea_2001 censuslowerlayersuperoutputarea_2001
2001 Census Middle Layer Super Output Area censusmiddlelayersuperoutputarea_2001 censusmiddlelayersuperoutputarea_2001
2001 Census Urban/Rural Indicator censusurbanruralindicator_2001 censusurbanruralindicator_2001
2001 Census Area Statistics (CAS) Ward censusareastatisticswardcode censusareastatisticswardcode

Other Census data fields

Description Addtags field name Tag name returned in output
2005 Statistical Ward statisticalwardcode_2005 statisticalwardcode_2005

Health administration data fields

Description Addtags field name Tag name returned in output
NHS Commissioning Region Code (ONS GSS) commissioningregioncode_gss commissioningregioncode_gss
NHS Commissioning Region Name commissioningregionname commissioningregionname
NHS Area Team Code (NHS) areateamcode_nhs areateamcode_nhs
NHS Area Team Code (ONS GSS) areateamcode_gss areateamcode_gss
NHS Area Team Name areateamname areateamname
NHS Clinical Commissioning Group Code (NHS) clinicalcommissioninggroupcode_nhs clinicalcommissioninggroupcode_nhs
NHS Clinical Commissioning Group Code (ONS GSS) clinicalcommissioninggroupcode_gss clinicalcommissioninggroupcode_gss
NHS Clinical Commissioning Group Name clinicalcommissioninggroupname clinicalcommissioninggroupname

Local government administration data fields

Description Addtags field name Tag name returned in output
Local Authority Ward Code localauthoritywardcode localauthoritywardcode
Local Authority Code localauthoritycode localauthoritycode
Local Authority Name localauthorityname localauthorityname
Electoral Ward Code electoralwardcode electoralwardcode
Electoral Ward Name electoralwardname electoralwardname
Electoral County Code electoralcountycode electoralcountycode
Electoral County Name electoralcountyname electoralcountyname
Parish Code parishcode parishcode
Local Education Authority code localeducationauthoritycode localeducationauthoritycode
Local Education Authority name localeducationauthorityname localeducationauthorityname

National government administration data fields

Description Addtags field name Tag name returned in output
Westminster Parliamentary Constituency Code parliamentaryconstituencycode parliamentaryconstituencycode
Westminster Parliamentary Constituency Name parliamentaryconstituencyname parliamentaryconstituencyname

European government administration data fields

Description Addtags field name Tag name returned in output
European Electoral Region Code europeanelectoralregioncode europeanelectoralregioncode
European Electoral Region Name europeanelectoralregionname europeanelectoralregionname

Mapping and navigational geography data fields

Description Addtags field name Tag name returned in output
Easting OS Grid Reference (1m precision in units of 1m) grideast1metre grideasting
Northing OS Grid Reference (1m precision in units of 1m) gridnorth1metre gridnorthing
Latitude (OSGB36) latitudeosgb36 latitudeosgb
Longitude (OSGB36) longitudeosgb36 longitudeosgb
Latitude (ETRS89) latitudeetrs89 latitude
Longitude (ETRS89) longitudeetrs89 longitude

Miscellaneous data fields

Description Addtags field name Tag name returned in output
National Park Code nationalparkcode nationalparkcode
Date of Introduction of Postcode (format: YYYYMM) postcodedateofintroduction postcodedateofintroduction