A simple JSON API for finding postal addresses

Easy Integration

Integrate with simple HTTPS request & JSON response

Low Cost

One simple, low cost price plan

Accurate

Uses the official Royal Mail Postcode Address File (PAF)

No Commitment

No subscription, just pay for the lookups you need

free trial
    API call limit 100 What happens when the limit is reached? Purchase credits Restricted to single site or app NoSupport Full Service Guarantee 99.9%Expiration 14 days
2018264761
£20 per 1000 credits
    API call limit Credits Purchased What happens when the limit is reached? Purchase additional credits Restricted to single site or app NoSupport Full Service Guarantee 99.9% Expiration1 year
(847) 941-7584
7733463721
Our data is very up-to-date. Our address data is regularly updated from various sources, including Royal Mail's Postcode Address File database, and is enhanced with real-time corrections from address owners/occupiers submitted through our site (no other API service offers this additional feature).
Just register a free account and purchase an API credits pack, upon which we will assign you a dedicated API key in order to use our API lookup service.
A lookup is a search of a full UK postcode against our entire address database.
Lookup credits are one flat low rate of 1.5p each. It's that simple.
All credits in a pack expire one calendar year after purchase. Upon this expiry, they are considered lost and non-refundable.
If your lookup fails to get a list of addresses for any reason (e.g. an invalid UK postcode was searched), no credits will be deducted.
All payments are securely processed through PayPal, which means you can pay with nearly any UK bank account or credit/debit card.
There are no contracts, overages, fees or any other additional charges. All you pay for is the number of lookups you wish to make.
Yes. While our service is designed to be self-service and fully automated, we offer support for any technical enquiry. Simply get in touch with us and we will get back to you within one business day (in most cases, within a couple of hours).
We guarantee availability of at least 99.9% from our high-performance multi-core dedicated server.

Example Code - Basic

HTTPS GET Endpoint:
/www.addressesandpostcodes.co.uk/api/pc2add/v1/basic/sw1a0aa/?key=your-api-key
JSON Response:
{
  "addresses": [
    {
      "source": "PAF",
      "addString": "House Of Commons,Houses Of Parliament,LONDON,SW1A 0AA",
      "lines": {
        "addLineOrg": "House Of Commons",
        "addLine1": "Houses Of Parliament",
        "addPostTown": "LONDON",
        "addLinePostcode": "SW1A 0AA" 
      },
      "pmUDPRN": "23747208",
      "pOrgName": "House Of Commons",
      "pBuildName": "Houses Of Parliament",
      "pTown": "LONDON",
      "pPostcodeType": "L",
      "pDPS": "1A" 
    }
  ],
  "totals": {
    "PAF": 1,
    "MR": 0,
    "CH": 0 
  },
  "misc": {
    "processingTime": 19,
    "creditBalance": 100 
  }
}

Example Code - Full

HTTPS GET Endpoint:
/www.addressesandpostcodes.co.uk/api/pc2add/v1/full/sw1a0aa/?key=your-api-key
JSON Response:
{
  "addresses": [
    {
      "source": "PAF",
      "addString": "House Of Commons,Houses Of Parliament,LONDON,SW1A 0AA",
      "lines": {
        "addLineOrg": "House Of Commons",
        "addLine1": "Houses Of Parliament",
        "addPostTown": "LONDON",
        "addLinePostcode": "SW1A 0AA" 
      },
      "pmUDPRN": "23747208",
      "pOrgName": "House Of Commons",
      "pBuildName": "Houses Of Parliament",
      "pTown": "LONDON",
      "pPostcodeType": "L",
      "pDPS": "1A" 
    },
    {
      "source": "CH",
      "addString": "COMMONWEALTH PARLIAMENTARY ASSOCIATION (UNITED KINGDOM BRANCH),WESTMINSTER HALL,HOUSE OF COMMONS,LONDON,SW1A 0AA",
      "lines": {
        "addLineOrg": "COMMONWEALTH PARLIAMENTARY ASSOCIATION (UNITED KINGDOM BRANCH)",
        "addLine1": "WESTMINSTER HALL",
        "addLine2": "HOUSE OF COMMONS",
        "addLine3": "LONDON",
        "addLinePostcode": "SW1A 0AA" 
      },
      "cComNum": "04606846",
      "cName": "COMMONWEALTH PARLIAMENTARY ASSOCIATION (UNITED KINGDOM BRANCH)",
      "cCategory": "PRI/LBG/NSC (Private, Limited by guarantee, no share capital, use of 'Limited' exemption)",
      "cIncorpDate": "2002-12-03",
      "cSIC1": "94920 - Activities of political organizations" 
    },
    {
      "source": "CH",
      "addString": "POLICY RESEARCH UNIT LIMITED,EAST CLOISTER,HOUSE OF COMMONS,LONDON,SW1A 0AA",
      "lines": {
        "addLineOrg": "POLICY RESEARCH UNIT LIMITED",
        "addLine1": "EAST CLOISTER",
        "addLine2": "HOUSE OF COMMONS",
        "addLine3": "LONDON",
        "addLinePostcode": "SW1A 0AA" 
      },
      "cComNum": "07960177",
      "cName": "POLICY RESEARCH UNIT LIMITED",
      "cCategory": "PRI/LTD BY GUAR/NSC (Private, limited by guarantee, no share capital)",
      "cIncorpDate": "2012-02-22",
      "cSIC1": "63990 - Other information service activities n.e.c." 
    },
    {
      "source": "CH",
      "addString": "UKIP PARLIAMENTARY RESOURCE UNIT LIMITED,HOUSES OF COMMONS,LONDON,SW1A 0AA",
      "lines": {
        "addLineOrg": "UKIP PARLIAMENTARY RESOURCE UNIT LIMITED",
        "addLine1": "HOUSES OF COMMONS",
        "addLine2": "LONDON",
        "addLinePostcode": "SW1A 0AA" 
      },
      "cComNum": "09676597",
      "cName": "UKIP PARLIAMENTARY RESOURCE UNIT LIMITED",
      "cCategory": "PRI/LTD BY GUAR/NSC (Private, limited by guarantee, no share capital)",
      "cIncorpDate": "2015-07-08" 
    }
  ],
  "postcodeInfo": {
    "pcPostcode": "SW1A 0AA",
    "pcArea": "SW",
    "pcAreaName": "South West London",
    "pcDistrict": "Westminster",
    "pcSector": "SW1A 0",
    "pcAddCountTotal": "1",
    "pcAddCountResidential": "0",
    "pcAddCountCommercial": "1",
    "pcCountry": "England",
    "pcRegion": "London",
    "pcWard": "St James's",
    "pcCoordLat": "51.499840",
    "pcCoordLong": "-0.124663",
    "pcConstituency": "Cities of London and Westminster",
    "pcMP": "Field, Mark",
    "pcParty": "Conservative" 
  },
  "totals": {
    "PAF": 1,
    "MR": 0,
    "CH": 3 
  },
  "misc": {
    "processingTime": 27,
    "creditBalance": 100 
  }
}

Example Code

< div id = "postcode_lookup" >
First Address Line
Second Address Line
Third Address Line
Town
< label > County
Postcode