XML - Postcode Evolution

The AFD Postcode Evolution Service is a server-side solution for accessing AFD datasets from either a server application, website or network clients. The service provides data in a flexible XML format which can be used in a wide range of applications and development environments.

A simple GET request to the service with your search parameters will return address data, bank data or validate account, card or email details in XML format. Making it easy to parse with any standard XML parser.

We provide both a hosted service and an installed service that you can install on your own server.

Get Started

Hosted Solution

To get started with our Evolution hosted solution request an evaluation.


Installed Solution

If you are looking for an installed solution you can download the installer:

Download - Windows



Quick Example

An example request for a single postcode lookup will look like this:


And will collect a collection of items that look like this:

<Item value="1">
    <Postcode>B6 4AA</Postcode>
    <Key>B6 4AA1001</Key>
        B6 4AA Royal Mail, Birmingham Mail Centre, St. Stephens Street, BIRMINGHAM

The fields in the original GET request have the following meaning:

  • Serial - Credential supplied by AFD
  • Password - Credential supplied by AFD
  • UserID - The ID of your application
  • Data - The kind of data that you are looking up, in our case we are looking up Address data
  • Task - The type of task that you are performing, different options are available depending on the lookup data provided
  • Fields - The fields that you would like to have returned, the “list” option returns the bare minimum number of fields for each entry.
  • Lookup - The lookup data provided by the user

To retrieve a detailed entry for a particular result we can change some of the parameters:


Which will return the full record for the selected address:

<Item value="1">
    <Organisation>Royal Mail</Organisation>
    <Property>Birmingham Mail Centre</Property>
    <Street>St. Stephens Street</Street>
    <Postcode>B6 4AA</Postcode>
    <UrbanRuralName>Urban Major Conurbation</UrbanRuralName>
    <Constituency>Birmingham, Ladywood</Constituency>
    <EERName>West Midlands</EERName>
    <OccupancyDescription>Large User Organisation</OccupancyDescription>
    <NHSName>West Midlands</NHSName>
    <NHSRegionName>Midlands and Eastern</NHSRegionName>
    <PCTName>Sandwell and West Birmingham</PCTName>
    <Affluence>Not classified</Affluence>
        Many organisations mixed with low, transient population
        Consumer commercial centres and offices. Much of this segment arises from business related sources, plus some unidentified residential properties
    <Product>AFD Postcode Plus</Product>
    <Key>B6 4AA1001</Key>
        B6 4AA Royal Mail, Birmingham Mail Centre, St. Stephens Street, BIRMINGHAM
    <Country>United Kingdom</Country>

Our extensive list of parameters and fields gives developers flexibility in their implementation and are fully documented in our user manuals.