Street-level address lookup

Returns UK addresses without the premise name or number for a postcode (e.g. NR14 7PZ).

Lookup cost: 1.5 credits

Request structure

http://ws.postcoder.com/pcw/[api-key]/street/uk/[postcode]

Optional parameters

lines The number of lines over which to split each address
include Include extra address fields within the address lines returned (see above)
exclude Exclude address fields within the address lines returned (see above)
format xml | json (default unless header of application/xml is detected)
addtags Add extra address fields to the return
identifier Identify your lookups to make debugging and reviewing stats easier
callback Use to specify the name of your JSONP callback function

Notes

  • Multiple addresses may be returned depending on your search criteria
  • Empty address fields are not returned in the response, so all fields should be treated as optional
  • Include geodata using /geo/ rather than /street/ in the request | Lookup cost: 1.9 credits

Response examples

Request: http://ws.postcoder.com/pcw/PCW45-12345-12345-1234X/street/uk/NR147PZ?format=json - View live response

[
    {
        "summaryline":"Fox Road, Framingham Pigot, Norwich, Norfolk, NR14 7PZ",
        "street":"Fox Road",
        "dependentlocality":"Framingham Pigot",
        "posttown":"Norwich",
        "county":"Norfolk",
        "postcode":"NR14 7PZ"
    }
]

Request: http://ws.postcoder.com/pcw/PCW45-12345-12345-1234X/street/uk/NR147PZ?format=xml - View live response

<Addresses xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <Address>
        <summaryline>Fox Road, Framingham Pigot, Norwich, Norfolk, NR14 7PZ</summaryline>
        <street>Fox Road</street>
        <dependentlocality>Framingham Pigot</dependentlocality>
        <posttown>Norwich</posttown>
        <county>Norfolk</county>
        <postcode>NR14 7PZ</postcode>
    </Address>
</Addresses>

Request: http://ws.postcoder.com/pcw/PCW45-12345-12345-1234X/geo/uk/NR147PZ?format=json - View live response

[
    {
        summaryline: "Fox Road, Framingham Pigot, Norwich, Norfolk, NR14 7PZ",
        street: "Fox Road",
        dependentlocality: "Framingham Pigot",
        posttown: "Norwich",
        county: "Norfolk",
        postcode: "NR14 7PZ",
        latitude: "52.5859730797",
        longitude: "1.3491603533",
        grideasting: "626976",
        gridnorthing: "303951"
    }
]

Response field descriptions

Field name Data type Description Example
summaryline String Summary Allies Computing Ltd, Manor Farm Barns, Fox Road, Framingham Pigot, Norwich, Norfolk, NR14 7PZ
pobox String PO Box
dependentstreet String Dependent street
street String Street Fox Road
doubledependentlocality String Double dependent locality
dependentlocality String Dependent locality Framingham Pigot
posttown String Post town Norwich
county String County Norfolk
postcode String Postcode NR14 7PZ