Skip to main content

​
AddressBase Premium Fields

Related Data Field in RequestDescriptionReturn Field response.address
UDPRNRoyal Mail Unique Delivery Point Reference Numberaddress.additionalItems.UDPRN and address.rmUDPRN
UPRNUPRN (Unique Property Reference Number)address.additionalItems.UPRN and address.uprn
LPI_KEYLPI Keyaddress.additionalItems.LPI_KEY and address.lpi.LPIKey
LPI_STATUSLPI Logical Statusaddress.lpi.LPILogicalStatus
USRNUSRN (Unique Street Reference Number)address.lpi.USRN
USRN_MATCH_INDIUSRN Match Indicatoraddress.lpi.USRNMatchIndicator
LEVELMemorandum of Vertical Positionaddress.lpi.level
OFFICIAL_FLAGStatus of the Addressaddress.lpi.OfficialFlag
BLPU_STATUSBLPU Logical Statusaddress.blpu.BLPULogicalStatus
BLPU_STATEBLPU Stateaddress.blpu.BLPUState
PARENT_UPRNParent UPRNaddress.additionalItems.ParentUPRN and address.blpu.ParentUPRN
X_COORDINATEEastingaddress.blpu.Easting
Y_COORDINATENorthingaddress.blpu.Northing
RPCRepresentative Point Codeaddress.blpu.RPC
BLPU_CUSTODIANLLPG Custodianaddress.blpu.LocalCustodianCode
BLPU_END_DATEBLPU End Dateaddress.blpu.BLPUEndDate
POSTAL_ADDRESSPostal Addressaddress.blpu.PostalAddressable
MULTI_OCC_COUNTMulti-Occupancy Countaddress.blpu.MultiOccCount
BLPU_STATE_DATEBLPU State Dateaddress.blpu.BLPUStateDate
BLPU_START_DATEBLPU Start Dateaddress.blpu.BLPUStartDate
BLPU_UPDATE_DATEBLPU Update Dateaddress.blpu.BLPULastUpdateDate
BLPU_ENTRY_DATEBLPU Entry Dateaddress.blpu.BLPUEntryDate
CLASS_CODEClass Codeaddress.classification,ClassificationCode
CLASS_PRIMARYClass Primaryaddress.classification ClassPrimaryText
CLASS_SECONDARYClass Secondaryaddress.classification ClassPrimaryText
CLASS_TERTIARYClass Tertiaryaddress.classification ClassTertiaryText
CLASS_QUATERNARYClass Quaternaryaddress.classification.ClassQuaternaryText
CLASS_END_DATEClass End Dateaddress.classification.ClassEndDate
CLASS_START_DATEClass Start Dateaddress.classification.ClassStartDate
CLASS_UDPATE_DATEClass Update Dateaddress.classification.ClassLastUpdateDate
CLASS_ENTRY_DATEClass Entry Dateaddress.classification.EntryDate
CLASS_SCHEMESchemeaddress.classification.ClassScheme
ORG_KEYUnique Key for Organisation Recordaddress.additionalItems.ORG_KEY and address.companyInformation.organisationKey
ORG_ORGANISATIONABP Organisation Nameaddress.companyInformation.organisationName
ORG_LEGAL_NAMEOrganisation Registered Legal Nameaddress.companyInformation.legalOrganisationLegalName
ORG_START_DATEOrganisation Start Dateaddress.companyInformation.organisationStartDate
ORG_END_DATEOrganisation End Dateaddress.companyInformation .organisationEndDate
ORG_UPDATE_DATEOrganisation Update Dateaddress.companyInformation.organisationLastUpdateDate
ORG_ENTRY_DATEOrganisation Entry Dateaddress.companyInformation.organisationEntryDate
XREFMAXREFMA Address Layer 2 TOIDaddress.osAl2Toid
XREFMIXREFMI Transport Network TOIDaddress.osItnToid
XREFMTXREFMT Topography Layer TOIDaddress.osTopoToid
XREFVCXREFVC Council Taxaddress.voaCtRecord
XREFVNXREFVN Non-Domestic Ratesaddress.voaNdrRecord
CLASS_KEYClass Keyaddress.classification.ClassKey
SAO_START_NUMBERSAO Start Numberaddress.lpi.SAOStartNumber
SAO_START_SUFFIXSAO Start Suffixaddress.lpi.SAOStartSuffix
SAO_END_NUMBERSAO End Numberaddress.lpi.SAOEndNumber
SAO_END_SUFFIXSAO End Suffixaddress.lpi.SAOEndSuffix
PAO_START_NUMBERPAO Start Numberaddress.lpi.PAOStartNumber
PAO_START_SUFFIXPAO Start Suffixaddress.lpi.PAOStartSuffix
PAO_END_NUMBERPAO End Numberaddress.lpi.PAOEndNumber
PAO_END_SUFFIXPAO End Suffixaddress.lpi.PAOEndSuffix
LANGUAGELanguageaddress.lpi.LPILanguage
LPI_START_DATELPI Start Dateaddress.lpi.LPIStartDate
LPI_END_DATELPI End Dateaddress.lpi.LPIEndDate
LPI_UPDATE_DATELPI Update Dateaddress.lpi.LPILastUpdateDate
LPI_ENTRY_DATELPI Entry Dateaddress.lpi.LPIEntryDate
AREA_NAMEArea Nameaddress.lpi.AreaName
SAO_TEXTSAO Textaddress.lpi.SAOText
PAO_TEXTPAO Textaddress.lpi.PAOText
ST_TYPEStreet Typeaddress.streetInformation.StreetType
ST_STATEStreet Stateaddress.streetInformation.StreetState
ST_SURFACEStreet Surface Finishaddress.streetInformation.StreetSurface
ST_CLASSStreet Classaddress.streetInformation.StreetClassification
ST_VERSIONStreet Versionaddress.streetInformation.StreetVersion
ST_END_DATEStreet End Dateaddress.streetInformation.StreetEndDate
ST_START_XStreet Start X (Easting)address.streetInformation.StreetStartEasting
ST_START_YStreet Start Y (Northing)address.streetInformation.StreetStartNorthing
ST_END_XStreet End X (Easting)address.streetInformation.StreetEndEasting
ST_END_YStreet End Y (Northing)address.streetInformation.StreetEndNorthing
ST_TOLERANCEStreet Toleranceaddress.streetInformation.StreetTolerance
ST_STATE_DATEStreet State Dateaddress.streetInformation.StateDate
ST_START_DATEStreet Start Dateaddress.streetInformation.StreetStartDate
ST_UPDATE_DATEStreet Update Dateaddress.streetInformation.StreetLastUpdateDate
ST_ENTRY_DATEStreet Entry Dateaddress.streetInformation.StreetEntryDate
ST_DESCRIPTIONStreet Nameaddress.streetDescriptor.StreetDescription
ST_LOCALITYStreet Locality Nameaddress.streetDescriptor.Locality
ST_TOWNStreet Town Nameaddress.streetDescriptor.TownName
ST_ADMIN_AREAHighway Authority Nameaddress.streetDescriptor.AdministrativeArea
ST_LANGUAGEStreet Descriptor Languageaddress.streetDescriptor.StreetLanguage

​
Multiple Residence Fields

Related Data Field in RequestDescriptionReturn Field response.address
UMRRNUMRRNaddress.additionalItems.UMRRN
Owning UDPRNOwningUDPRNaddress.additionalItems.OwningUDPRN
OwningAKOwning Address Keyaddress.additionalItems.OwningAK
OwningOKOwning Organisation Keyaddress.additionalItems.OwningOK

​
Business Fields

Related Data Field in RequestDescriptionReturn Field response.address
TELTelephone Numberaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “TEL”
FAXFax Numberaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “FAX”
SIC03UK 2003 SIC Codeaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “SIC03”
NUMEMPCOEmployees at Companyaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “NUMEMPCO”
NUMEMPEmployees at Siteaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “NUMEMP”
HOFHead Office Flagaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “HOF”
TOTurnoveraddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “TO”
YEARSTARYear Startedaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “YEARSTAR”
SIC03TEXT2003 SIC Descriptionaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “SIC03TEXT”
ExecutiveCountCount of named executivesaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “ExecutiveCount”
Ex1_FunctionExecutive 1 functionaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “Ex1_Function”
Ex1_FirstNameExecutive 1 first nameaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “Ex1_FirstName”
Ex1_SurnameExecutive 1 surnameaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “Ex1_Surname”
Ex1_SalutationExecutive 1 salutationaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “Ex1_Salutation”
Ex1_SexExecutive 1 genderaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “Ex1_Sex”
Ex2_FunctionExecutive 2 functionaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “Ex2_Function”
Ex2_FirstNameExecutive 2 first nameaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “Ex2_FirstName”
Ex2_SurnameExecutive 2 surnameaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “Ex2_Surname”
Ex2_SalutationExecutive 2 salutationaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “Ex2_Salutation”
Ex2_SexExecutive 2 genderaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “Ex2_Sex”
Ex3_FunctionExecutive 3 functionaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “Ex3_Function”
Ex3_FunctionExecutive 3 functionaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “Ex1_Surname”
Ex3_FirstNameExecutive 3 first nameaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “Ex3_FirstName”
Ex3_SurnameExecutive 3 surnameaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “Ex3_Surname”
Ex3_SalutationExecutive 3 salutationaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “Ex3_Salutation”
Ex3_SexExecutive 3 genderaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “Ex3_Sex”
Ex4_FunctionExecutive 4 functionaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “Ex4_Function”
Ex4_FirstNameExecutive 4 first nameaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “Ex4_FirstName”
Ex4_SurnameExecutive 4 surnameaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “Ex4_Surname”
Ex4_SalutationExecutive 4 salutationaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “Ex4_Salutation”
Ex4_SexExecutive 4 genderaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “Ex4_Sex”
Ex5_FunctionExecutive 5 functionaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “Ex5_Function”
Ex5_FirstNameExecutive 5 first nameaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “Ex5_FirstName”
Ex5_SurnameExecutive 5 surnameaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “Ex5_Surname”
Ex5_SalutationExecutive 5 salutationaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “Ex5_Salutation”
Ex5_SexExecutive 5 genderaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “Ex5_Sex”
Ex6_FunctionExecutive 6 functionaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “Ex6_Function”
Ex6_FirstNameExecutive 6 first nameaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “Ex6_FirstName”
Ex6_SurnameExecutive 6 surnameaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “Ex6_Surname”
Ex6_SalutationExecutive 6 salutationaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “Ex6_Salutation”
Ex6_SexExecutive 6 genderaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “Ex6_Sex”
DecsFunctionDecisions responsibility functionaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “DecsFunction”
DecsFirstNameDecisions responsibility first nameaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “DecsFirstName”
DecsSurnameDecisions responsibility surnameaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “DecsSurname”
DecsSalutationDecisions responsibility salutationaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “DecsSalutation”
DecsGenderDecisions responsibility genderaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “DecsGender”
CRONUMBERCompany Registration Numberaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “CRONUMBER”
UCRNUnique Company Registration Numberaddress.groupedAdditionalItems - keyed on “BusinessData”

item - keyed on “UCRN”

​
Not Yet Built Specific Fields

Related Data Field in RequestDescriptionReturn Field response.address
NOTYETBUILTNot Yet Builtaddress.additionalItems.NOTYETBUILT

​
LPS Pointer Specific Fields

Related Data Field in RequestDescriptionReturn Field response.address
TOWNLANDThe town allocated as the main postal centre for an area. May differ from the TOWN field in the main addressaddress.OnsPointerInformation.Ptr.Townland
UNIQUE_BUILDING_ID12-digit identifying a Primary Addressable Object defined by the ‘physical footprint’ of the building shelladdress.additionalItems.UniqueBuildingId and

address.OnsPointerInformation.PtrUniqueBuildingId
LOCAL_COUNCILThe name of the administrative area (local council) in which the building existsaddress.OnsPointerInformation.PtrLocalCouncil
X_COR1m accurate easting coordinate based on the Irish Gridaddress.onsPointerInformation.PtrXcor
Y_COR1m accurate northing coordinate based on the Irish Gridaddress.OnsPointerInformation.PtrYcor
TEMP_COORDSIf “Y”, then indicates that PrtXcor and PtrYcor are temporary coordinates. Null indicates that PtrXcor and PtrYcor are permanentaddress.OnsPointerInformation.PtrTempCoord
BUILDING_STATUSThe current physical status of the building. See codelist: LPS_BUILDING_STATUSaddress.OnsPointerInformation.PtrBuildingStatus
ADDRESS_STATUSThe current logical status of the address. See codelist: LPS_ADDRESS_STATUSaddress.OnsPointerInformation.PtrAddressStatus
CLASSIFICATIONA code signifying the current use of the building e.g. “ND_culture”address.OnsPointerInformation.PtrClassCode
CREATION_DATEThe date when an address was first entered into the system by the local counciladdress.OnsPointerInformation.PtrCreationDate
COMMENCEMENT_DATEThe date when the construction of the property beganaddress.OnsPointerInformation.PtrCommencementDate
ARCHIVED_DATEThe date when an address is deemed to be no longer in useaddress.OnsPointerInformation.PtrArchivedDate

​
Geographic Fields

Related Data Field in RequestDescriptionReturn Field response.address
EASTING6-digit grid co-ordinate e.g. 341449.21address.geographicInformation.easting
NORTHING6-digit grid co-ordinate e.g. 368192.68address.geographicInformation.northing
LATITUDEDigital latitude value (future use)address.geographicInformation.latitude
LONGITUDEDigital longitude value (future use)address.geographicInformation.longitude

​
GBG and RM Unique IDs

Related Data Field in RequestDescriptionReturn Field response.address
GBGURN_1Unique address keyaddress.additionalItems.GBGURN_1
GBGURN_2Unique key (future use)address.additionalItems.GBGURN_2
ADDRESSSOURCEData source for the returned addressaddress.additionalItems.ADDRESSSOURCE
ORGKEYRoyal Mail Organisation Keyaddress.additionalItems.ORGKEY
ADDKEYRoyal Mail Address Keyaddress.additionalItems.ADDKEY