Cards & Wallets · Risk Management · Optimize Verify

Address Lookup

Get a list of addresses for a given post code.

This service is typically used before a KYC service in order to better prepare and format the address inputs.

API response examples

Lookup for IV448TZ using profile eKYC

GET /optimizeverify/addresslookup/uk/{postCode}

cURL

curl -X GET "{targetEnvironmentPath}/optimizeverify/addresslookup/uk/IV448TZ?profileShortCode=eKYC" \
  -H "Authorization: Basic {base64(licenceKey:clientKey)}" \
  -H "Accept: application/json"

Response

HTTP/1.1 200

{
  "TransactionReference": "02c124eb-444d-47d2-ad5f-19bb31b10254",
  "AddressList": [
    {
      "HouseName": "BLENLEY LODGE",
      "HouseNumber": "",
      "UnitNumber": null,
      "AddressLine1": "ROWLANDS CLOSE",
      "AddressLine2": "BARNTON MILLS",
      "StreetType": null,
      "District": "",
      "PostTown": "TRAINING TOWN",
      "County": "ISLE OF SKYE",
      "StateProvinceCode": null,
      "PostCode": "IV448TZ",
      "Country": null,
      "FuzzyAddressString": null,
      "PTC_ABS_Code": "PTCABSTEST0004506",
      "FirstYearAtAddress": null,
      "LastYearAtAddress": null
    },
    {
      "HouseName": "BRIARFIELD",
      "HouseNumber": "",
      "UnitNumber": null,
      "AddressLine1": "ROWLANDS CLOSE",
      "AddressLine2": "BARNTON MILLS",
      "StreetType": null,
      "District": "",
      "PostTown": "TRAINING TOWN",
      "County": "ISLE OF SKYE",
      "StateProvinceCode": null,
      "PostCode": "IV448TZ",
      "Country": null,
      "FuzzyAddressString": null,
      "PTC_ABS_Code": "PTCABSTEST0004256",
      "FirstYearAtAddress": null,
      "LastYearAtAddress": null
    },
    {
      "HouseName": "BRONALLT",
      "HouseNumber": "",
      "UnitNumber": null,
      "AddressLine1": "ROWLANDS CLOSE",
      "AddressLine2": "BARNTON MILLS",
      "StreetType": null,
      "District": "",
      "PostTown": "TRAINING TOWN",
      "County": "ISLE OF SKYE",
      "StateProvinceCode": null,
      "PostCode": "IV448TZ",
      "Country": null,
      "FuzzyAddressString": null,
      "PTC_ABS_Code": "PTCABSTEST0004409",
      "FirstYearAtAddress": null,
      "LastYearAtAddress": null
    },
    {
      "HouseName": "BRYN MEURIG",
      "HouseNumber": "",
      "UnitNumber": null,
      "AddressLine1": "ROWLANDS CLOSE",
      "AddressLine2": "BARNTON MILLS",
      "StreetType": null,
      "District": "",
      "PostTown": "TRAINING TOWN",
      "County": "ISLE OF SKYE",
      "StateProvinceCode": null,
      "PostCode": "IV448TZ",
      "Country": null,
      "FuzzyAddressString": null,
      "PTC_ABS_Code": "PTCABSTEST0004407",
      "FirstYearAtAddress": null,
      "LastYearAtAddress": null
    },
    {
      "HouseName": "BRYNDERI",
      "HouseNumber": "",
      "UnitNumber": null,
      "AddressLine1": "ROWLANDS CLOSE",
      "AddressLine2": "BARNTON MILLS",
      "StreetType": null,
      "District": "",
      "PostTown": "TRAINING TOWN",
      "County": "ISLE OF SKYE",
      "StateProvinceCode": null,
      "PostCode": "IV448TZ",
      "Country": null,
      "FuzzyAddressString": null,
      "PTC_ABS_Code": "PTCABSTEST0004381",
      "FirstYearAtAddress": null,
      "LastYearAtAddress": null
    }
  ]
}