Property Demographics
GEThttps://property-api.k8s.outra.co.uk/api/v2/property/demographics
API keyJSON
Get DEMOGRAPHICS field group data for a property by UPRN. Returns modelled household labels — lifestage, family composition, affluence and affordability, vehicle ownership and occupancy — to support audience insight, targeting and analytics.
Purpose
- Household insight — a labelled profile of the likely household.
- Segmentation & targeting — affluence, lifestage and affordability labels for audience building.
- Occupancy modelling — occupant type with a confidence score and modelled flag.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
uprn | integer | Required | Property UPRN. Positive integer, maximum 12 digits. Minimum 1, maximum 999999999999. |
curl 'https://property-api.k8s.outra.co.uk/api/v2/property/demographics?uprn=100023336956' \
-H 'accept: application/json' \
-H 'Authorization: Api-Key {api_key}'Modelled labels
Demographics are modelled, human-readable labels suitable for aggregated and model-driven use. OCCUPANT_TYPE carries $CONFIDENCE and $MODELLED companion keys.
Status codes
| Code | Description |
|---|---|
200 | Demographics retrieved successfully |
401 | Authentication failed or API key invalid |
422 | Request validation failed |
429 | Rate limit exceeded |
Field reference
Lifestage & householdDEMOGRAPHICS
life_stage_profession_label, life_stage_household_label
Lifestage labels.
family_composition_label
Household composition.
occupant_type
Owner-occupied, rented or alternative occupancy.
Affluence & affordabilityDEMOGRAPHICS
purchasing_power_level_label
Spending-power band.
first_time_buyer_affordability_label
First-time-buyer affordability.
vehicle_ownership_label
Vehicle ownership.
Property & areaDEMOGRAPHICS
property_size_label, property_features_label
Property descriptors.
area_type_label, energy_rating_label
Area and energy context.
sale_anniversary_quarter_label, sale_anniversary_year_label
Sale anniversary timing.
Typical use cases
Audience segmentation
Build audiences by lifestage, affluence and affordability.
Media planning
Inform channel and creative decisions with household-level labels.
Household analytics
Support aggregated analysis with consistent segmentation.