Search Postcodes and Addresses

 

The FintechOS Ideal Postcodes Connector offers the possibility of searching databases for valid address data. Institutions can add the connector to a digital journey and retrieve the needed information from public records. This functionality helps speed up onboarding processes and validating addresses.

IMPORTANT!  
The below walkthrough is a proposition on how to use the FintechOSIdeal Postcodes Connector in a digital journey to search for accurate address data.

Follow the below steps to access and retrieve information using this connector.

1 Access Ideal Postcodes Connector

1. Log into the FintechOS Portal using the given credentials.

2. Log into the Ideal Postcodes platform with the credentials provided by them.

NOTE  
The user and password are obtained from the Ideal Postcodes platform. Additional information can be found on the Installation page.

3. From the FintechOS Portal main menu expand My Projects and click Postcodes.

4. Select Search by Address or Postcode. The FTOS_EXTD_POST_Addresses_Search List page opens.

5. At the top-right corner of the screen, click the Insert button. The Add FTOS_EXTD_POST_Addresses_Search- Addresses Search page opens. Fill in the following fields:

HINT  
To make a search, only the postcode or a part of the address (for example the street name) is needed. Adding extra information in the available fields returns structured and accurate data. To add additional data to the search, click the Expand filters ↓ button.
NOTE  

When the search is made using the address and the postal code, then the results returned are based on the address. If the inputted data includes the UDPRN number, then the results returned are based only on the UDPRN.
Field RequiredTypeDescription
Address SearchYesTextInput the UK address. details
Postcode SearchYesTextInput the UK postal code. For example: SW1A 2AA
UDPRNYesTextInput the Unique Delivery Point Reference Number. The UDPRN is an 8-character code used by Royal Mail to identify unique delivery addresses.
Limit NoNumericSpecifies the maximum number of suggestions to retrieve. The default limit is 10, unless a postcode is queried, then all addresses at that postcode are returned.
PageNoNumeric0 indexed indicator of the page of results to receive. Virtually all postcode results are returned on page 0. A small number of Multiple Residence postcodes may need pagination (for example, if there are more than 100 premises).

Filter

No

Text

Comma separated whitelist of address elements to return.
Postcode OutwardNoTextFilter by outward code.
Postcode AreaNoTextThe postcode_area. For example: SW Can be combined with query to perform a postcode and building number/ name search.
Postcode SectorNoTextThe postcode sector. For example: SW1A 2.
Post TownNoTextFilter by town.
UPRNNoTextFilter by the Unique Property Reference Number (UPRN). UPRNs are the unique identifier for every addressable location in UK.
CountryNoText

Filter by country. Possible values are

  • England

  • Scotland

  • Wales

  • Northern Ireland

  • Jersey

  • Guernsey

  • Isle of Man

SU Organisation IndicatorNoTextFilter by Organisation Indicator. Useful for separating organisational and residential addresses.
BoxNoTextRestrict search to a geospatial box determined by the 'top-left' and 'bottom-right' gelocations. Only one geospatial box can be provided.
Bias Postcode OutwardNoTextThe address results that closely matches the chosen postcode outward value.
Bias Postcode AreaNoTextThe address results that closely matches the chosen postcode area value.
Bias Postcode SectorNoTextThe address results that closely matches the chosen postcode sector value.
Bias Post TownNoTextThe address results that closely matches the chosen postcode town value.
Bias ThoroughfareNoTextThe address results that closely matches the chosen thoroughfare value.
Bias CountryNoTextThe address results that closely matches the chosen country value.
Bias PostcodeNoTextThe address results that closely matches the chosen postcode value.
Bias LonlatNoTextBias search to a geospatial circle determined by an origin and radius in meters. Maximum radius is 50000.
 

2 Address Data Returned

6. Click the Next button. The EDIT FTOS_EXTD_POST_Addreses_search - Addresses Search Results page opens. The following information is displayed:

Field RequiredTypeDescription
CountryNoNoDisplays the country from the address.
CountyNoNoDisplays the county from the address.
Postal CodeNoNoDisplay's the postal code from the address.
ThoroughfareNoNoDisplays the main street or avenue from the address.
 

7. Click the Finish button. The Search Lexis Nexis List page is displayed.

NOTE  
To make changes to the search, click the Previous button to go back to the Add FTOS_EXTD_POST_Addresses_Search- Addresses Search page.

3 Additional Address Data

8. Double-click on the wanted record from the results list to view additional information. The Edit FTOS_EXTD_POST_Addresses page opens displaying the following additional information:

HINT  
In the Edit FTOS_EXTD_POST_Addresses page, information can be added or edited, depending on the case.
Field RequiredTypeDescription
Administrative CountyNoTextThe current administrative county to which the postcode has been assigned.
Building NameNoTextThe building name.
Building NumberNoTextThe building number.
CountryNoTextThe country to which the postcode belongs to.

Possible values are

  • England

  • Scotland

  • Wales

  • Northern Ireland

  • Jersey

  • Guernsey

  • Isle of Man

CountyNoTextThe county from the address.
Delivery Point SuffixNoTextA unique Royal Mail two-character code (the first numeric and the second alphabetical), which, when added to the postcode, it enables each live delivery point to be uniquely identified.
Department NameNoTextUsed to supplment Organisation Name to identify a department within the organisation.
Dependant LocalityNoTextThe dependenat locality of the address.
Dependant ThoroughfareNoTextWhen a thoroughfare name is used twice in the same Post Town, the dependant thoroughfare is added to uniquely identify a delivery point.
Administrative DistrictNoTextThe administrative district.
Double Dependant LocalityNoTextUsed to supplement the dependant locality,
EastingsNoTextEastings reference using the Ordnance Survey National Grid reference system.
LatitudeNoTextThe latitude of the postcode (WGS84/ETRS89)
Address Line OneNoTextThe first address Line. Often contains premise and thoroughfare information.
Address Line TwoNoTextThe second address Line. Often contains thoroughfare and locality information.
Address Line ThreeNoTextThe third address line.
LongitudeNoTextThe longitude of the postcode (WGS84/ETRS89).
NameNoTextThe name of the address.
LatitudeNoTextThe latitude of the postcode (WGS84/ETRS89)
Organisation NameNoTextName of the organisation registered at this address.
Postal Code Search Lookup IDNoTextThe postal code ssearch lLookup ID.
PO Box numberNoTextThe PO Box number.
Postal CountyNoTextPostal counties were used for the distribution of mail before the Postcode system was introduced in the 1970s. The Former Postal County was the Administrative County at the time.
Postal CodeNoTextCorrectly formatted postcode.
Postcode Inward CodeNoTextThe second part of a postcode is known as the inward Code. e.g. The inward code of ID1 1QD is 1QD.
Postcode Outward CodeNoTextThe first part of a postcode is known as the outward code. e.g. The outward code of ID1 1QD is ID1.
Postcode TypeNoTextIt can only take the values "S" or "L" indicating small or large respectively.
Post TownNoTextPost Town is mandatory for delivery of mail to a delivery point. This is not necessarily the nearest town geographically, but a routing instruction to the Royal Mail delivery office sorting mail for that delivery point.
PremiseNoTextNumber to identify premise on a thoroughfare or dependant thoroughfare
Sub Building NameNoTextWhen a premise is split into individual units such as flats, apartments or business units.
Small User Organisation IndicatorNoTextSmall User Organisation Indicator can have the values "Y" or space. A value of "Y" indicates that a Small User Organisation is present at this address.
ThoroughfareNoTextAlso known as the street or road name. In general each Thoroughfare Name will have a separate Postcode. Longer Thoroughfares with high number ranges often have multiple Postcodes covering the entire length of the road, with breaks at suitable points e.g. junctions or natural breaks in the road.
Traditional CountyNoTextTraditional counties are provided by the Association of British Counties. It’s historical data, and can date from the 1800s.
Unique Delivery Point Reference NumberNoTextThe unique delivery point reference number.
Multiple Residence Unique IDNoTextUMPRNs are a unique numeric code for any Multiple Residence household on the optional Multiple Residence dataset
Unique Property Reference NumberNoTextUnique Property Reference Number is maintained by the Ordnance Survey (OS). Local governments in the UK have allocated a unique number for each land or property.
Administrative WardNoTextThe current administrative/electoral area to which the postcode has been assigned.
 

9. At the top-right corner of the screen, click the Save and Close button. The EDIT FTOS_EXTD_POST_Addreses_search - Addresses Search Results displays.