--- title: "Retrieve properties comparable to the given PID." method: GET path: "/comparables/{pid}" tags: ["Comparables"] --- # Retrieve properties comparable to the given PID. `GET /comparables/{pid}` ## Path parameters - `pid` string, required — Property identifier in format xxx-xxx-xxx ## Response `200` Successful Response - ComparablesResponse — Response schema for comparable properties. - `pid` string, required — Property identifier in format xxx-xxx-xxx - `comparables` ComparableProperty[], required - `address` PropertyAddressMetadata — Formatted address details and related map metadata. - `property_address` string, nullable — Display-ready mailing address for the property. - `unit_number` string, nullable — Unit, suite, or apartment identifier for the property. - `street_number` string, nullable — Street number or number range for the property. - `street_number_from` string, nullable — Starting street number for the property. - `street_number_to` string, nullable — Ending street number for the property when a range is provided. - `street_direction` string, nullable — Street direction or quadrant (e.g., W, NE). - `street_name` string, nullable — Normalized street name for the property. - `city` string, nullable — Normalized city name - `postal_code` string, nullable — Postal or ZIP code for the property. - `address_query` string, nullable — Formatted address string used for map queries. - `geo_coordinate_query` string, nullable — Comma separated latitude/longitude value for map lookups. - `distance_to_subject_property` string, nullable — Human readable distance from the comparable to the subject property. - `distance_to_subject_property_meters` number, nullable — Numeric distance from the comparable to the subject property in meters. - `assessment` BCAssessmentSection — Valuation metrics sourced from BC Assessment. - `assessment_area_code` integer, nullable - `assessment_area` string, nullable - `jurisdiction_code` integer, nullable - `jurisdiction` string, nullable - `roll_number` string, nullable - `neighbourhood_code` string, nullable - `neighbourhood` string, nullable - `last_land_value_amount` number, nullable — Most recent assessed value assigned to the land portion. - `last_improvement_value_amount` number, nullable — Most recent assessed value of the improvements on the parcel. - `last_total_value_amount` number, nullable — Most recent total assessed value of the property. - `previous_total_value_amount` number, nullable — Previous year's total assessed value. - `price_per_square_foot` number, nullable — Derived price per finished square foot using the latest assessment. - `year_over_year_change` number, nullable — Year over year percentage change of the assessment value. - `usage` PropertyUsageSection — Classification and jurisdiction metadata describing how the parcel is used. - `use_code` integer, nullable - `use_description` string, nullable - `unit_type_code` integer, nullable - `unit_type_description` string, nullable - `development_class` integer, nullable - `development_class_sign` string, nullable - `actual_use_type` string, nullable - `manual_class_type` string, nullable - `is_rural_property` boolean, nullable - `zoning_code` string, nullable - `zoning_description` string, nullable - `school_district` string, nullable - `regional_district` string, nullable - `electoral_area` string, nullable - `hospital_district` string, nullable - `improvement_district` string, nullable - `local_area` string, nullable - `exterior` ExteriorDataSection — Exterior construction, site dimensions, parking, and amenity data. - `year_built` integer, nullable - `effective_year` integer, nullable - `foundation_type_code` string, nullable - `foundation_type` string, nullable - `covered_deck_area` number, nullable - `uncovered_deck_area` number, nullable - `carports` integer, nullable - `single_garages` integer, nullable - `multi_garages` integer, nullable - `parking_summary` string, nullable — Human readable summary of available parking counts. - `has_pool` boolean, nullable - `pool` boolean, nullable - `other_buildings` boolean, nullable - `exterior_type_code` integer, nullable - `exterior_type_description` string, nullable - `corner_lot` boolean, nullable - `waterfront_lot` boolean, nullable - `water_lot` boolean, nullable - `prime_view_lot` boolean, nullable - `good_view_lot` boolean, nullable - `fair_view_lot` boolean, nullable - `lot_size_sq_ft` number, nullable — Lot size expressed in square feet. - `lot_size_text` string, nullable — Formatted lot size string including square feet and acres. - `lot_size_freeform` string, nullable — Freeform lot size value captured by BC Assessment. - `lot_width_ft` number, nullable — Lot width in feet. - `lot_depth_ft` number, nullable — Lot depth in feet. - `interior` InteriorDataSection — Interior counts, configuration details, and square-footage metrics. - `stories` number, nullable - `bedrooms` integer, nullable - `bathrooms_4_piece` integer, nullable - `bathrooms_3_piece` integer, nullable - `bathrooms_2_piece` integer, nullable - `bathroom_total` integer, nullable - `fireplaces` integer, nullable - `fireplace_total` integer, nullable - `fireplace_type` string, nullable - `total_basement_area` number, nullable - `finished_basement_area` number, nullable - `basement_unfinished_area` integer, nullable - `basement_finished_area` integer, nullable - `main_finished_area` integer, nullable - `total_finished_area` number, nullable — Total finished area in square feet for the primary structure. - `other` OtherSection — Additional jurisdictional and legal identifiers. - `owner_address` string, nullable - `characteristics` string, nullable - `legal_description` string, nullable — Formatted legal description string. - `additional_pids` string, nullable — Comma separated list of additional parcel identifiers. - `legal_lot` string, nullable — Lot identifier parsed from the legal description. - `legal_block` string, nullable — Block identifier parsed from the legal description. - `legal_section` string, nullable — Section identifier parsed from the legal description. - `legal_township` string, nullable — Township identifier parsed from the legal description. - `legal_range` string, nullable — Range identifier parsed from the legal description. - `legal_meridian` string, nullable — Meridian identifier parsed from the legal description. - `legal_plan` string, nullable — Plan identifier parsed from the legal description. - `legal_district_lot` string, nullable — District lot identifier parsed from the legal description. - `legal_land_district` string, nullable — Land district identifier parsed from the legal description. - `alr` boolean, nullable - `coop` boolean, nullable - `sale` PropertySaleSection — Latest sale metadata for the property. - `sale_date` string, date, nullable — Recorded date of the most recent sale. - `sale_price` number, nullable — Recorded consideration amount for the most recent sale. ## Other responses - `422` — Validation Error --- [API](https://skmtc.net/landcor/apis/landcor-property-api.md) · [All operations](https://skmtc.net/landcor/apis/landcor-property-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/landcor/landcor-property-api/versions/45a7cc8f5b96/schema)