Skip to main content
← Back to Address Fields This page covers the logic and example scenarios for the HasSubPremise field, which is available in US PDH data. For the full set of address fields, see Address Fields.

​
Field values

ValueMeaning
YesThe verified premise contains one or more sub premises (for example, apartments or suites).
NoThe verified record is itself a sub premise, or the verified premise contains no sub premises.
blankNo sub premise information is available (typically when the address was only verified to thoroughfare or a lower level).

​
How HasSubPremise interacts with AVC

The value of HasSubPremise should always be interpreted alongside the AVC code. The table below summarises the common combinations.
AVCVerification levelTypical HasSubPremiseInterpretation
V4Verified to premise levelYesPremise verified and contains sub premises.
V4Verified to premise levelNoPremise verified and contains no sub premises.
V5Verified to sub premise levelNoRecord is itself a sub premise, so it cannot contain further sub premises.
A5Ambiguous at sub premise levelNoSub premise level record; no further sub premises to flag.
V3Verified to thoroughfare (street) levelblankNo sub premise information available.

​
Scenarios

The following scenarios illustrate how the HasSubPremise flag behaves for different verification outcomes.

​
Scenario 1: Verified premise level property that contains sub premises

FieldValue
HasSubPremiseYes
AVCV4
Verified address999 Baker Way San Mateo CA 94404 USA
The property has been verified to premise level, so the AVC is V4. It also contains one or more sub premises, so HasSubPremise is set to Yes.

​
Scenario 2: Verified sub premise level property

FieldValue
HasSubPremiseNo
AVCV5
Verified address999 Baker Way Ste 1 San Mateo CA 94404 USA
The property has been verified as a sub premise, so the AVC is V5. A sub premise cannot itself contain further sub premises, so HasSubPremise is set to No.

​
Scenario 3: Verified premise level property with incorrect sub premise data

FieldValue
HasSubPremiseYes
AVCV4
Verified address999 Baker Way Ste 21 San Mateo CA 94404 USA
The property has been verified to premise level (AVC V4) because the supplied sub premise information was incorrect. The premise does contain sub premises, so HasSubPremise is set to Yes.

​
Scenario 4: Verified premise level property with no sub premises

FieldValue
HasSubPremiseNo
AVCV4
Verified address121 Private Road 3697 Paradise TX 76073-4800 USA
The property has been verified to premise level (AVC V4) and contains no sub premises, so HasSubPremise is set to No.

​
Scenario 5: Ambiguous sub premise level property

FieldValue
HasSubPremiseNo
AVCA5
Verified address1 Chestnut St Ste 3Y Nashua NH 03060-9306 USA
The AVC code of A5 means there is more than one close reference data match at sub premise level. Because this is a sub premise level record, the sub premise does not contain further sub premises, so HasSubPremise is set to No.

​
Scenario 6: No sub premise information

FieldValue
HasSubPremiseblank
AVCV3
Verified address8055 veterans blvd redwoodcity ca usa
The property was only verified to the thoroughfare (street) level, so no sub premise information is available and HasSubPremise is returned blank.