---
title: "Get property details by ID"
method: GET
path: "/v2/property/{property_id}"
tags: ["Property V2"]
---

# Get property details by ID

`GET /v2/property/{property_id}`

Retrieve detailed property information by Whitepages property ID.

Accepts either a Whitepages property ID (prefix ``R``) or an address ID
(prefix ``A``). Address IDs are resolved to the associated property
before lookup.

This endpoint returns comprehensive property data including physical
characteristics, tax assessment information, ownership details, mortgage
history, predictive insights, and current residents.

To obtain a property_id, first use the "Search for property by address"
endpoint (/v2/property/), which returns basic property information
including the property_id needed for this request.

## Path parameters

- `property_id` string, required — Whitepages property identifier (capital 'R' prefix) or address identifier (capital 'A' prefix). Both are 11 characters long.

## Response `200`

Property details retrieved successfully

- DetailResponseDtoPropertyDetailsV2Dto
  - `result` PropertyDetailsV2Dto, required — Full property information for details endpoint.
    - `property_id` string, required — Unique property identifier
    - `address_id` string, nullable — Unique address identifier
    - `apn` string, nullable — Assessor's Parcel Number
    - `property_address` PropertyAddressDto, required — Property address information.
      - `full_address` string, required — Complete formatted address string
      - `line1` string, required — Street address line (house number and street)
      - `city` string, required — City name
      - `state` string, required — Two-letter state code
      - `zip` string, required — 5-digit ZIP code
      - `house` string, required — House or building number
      - `street` string, required — Street name
      - `street_type` string, nullable — Street suffix (St, Ave, Blvd, etc.)
      - `county` string, nullable — County name
    - `mailing_address` PropertyAddressDto — Property address information.
      - `full_address` string, required — Complete formatted address string
      - `line1` string, required — Street address line (house number and street)
      - `city` string, required — City name
      - `state` string, required — Two-letter state code
      - `zip` string, required — 5-digit ZIP code
      - `house` string, required — House or building number
      - `street` string, required — Street name
      - `street_type` string, nullable — Street suffix (St, Ave, Blvd, etc.)
      - `county` string, nullable — County name
    - `geolocation` GeolocationDto — Geographic coordinates.
      - `lat` number, required — Latitude coordinate
      - `lng` number, required — Longitude coordinate
    - `year_built` integer, nullable — Year the property was originally constructed
    - `effective_year_built` integer, nullable — Effective year built accounting for major renovations
    - `property_purpose` string, nullable — Primary use (residential, commercial, industrial)
    - `living_sqft` integer, nullable — Livable square footage
    - `lot_sqft` integer, nullable — Total lot size in square feet
    - `ground_floor_sqft` integer, nullable — Ground floor square footage
    - `basement_sqft` integer, nullable — Basement square footage
    - `basement_type` string, nullable — Basement type (full, partial, none)
    - `stories` integer, nullable — Number of stories
    - `bedrooms` integer, nullable — Number of bedrooms
    - `bathrooms` integer, nullable — Number of bathrooms
    - `has_pool` boolean, nullable — Whether the property has a pool
    - `garage_type` string, nullable — Garage type (attached, detached, carport, none)
    - `roof_covering` string, nullable — Roof material type
    - `heating_fuel` string, nullable — Primary heating fuel type
    - `condition` string, nullable — Overall property condition
    - `build_quality` string, nullable — Construction quality rating
    - `owner_occupied` string, nullable — Whether property is owner-occupied
    - `is_vacant` boolean, nullable — Whether the property is currently vacant
    - `assessed_info` AssessedInfoDto — Property tax assessment information.
      - `market_value` integer, nullable — Estimated market value in USD
      - `assessed_value` integer, nullable — Tax-assessed value in USD
      - `property_tax_amount` number, nullable — Annual property tax amount in USD
      - `property_tax_percent` number, nullable — Effective property tax rate as percentage
    - `ownership_info` OwnershipInfoDetailsDto — Detailed ownership information for property details.
      - `owner_type` string, nullable — Type of ownership (individual, corporate, trust)
      - `sale_date` string, nullable — Most recent sale date (YYYY-MM-DD)
      - `last_sale_amount` integer, nullable — Most recent sale price in USD
      - `mortgages` MortgageDto[] — Mortgage records associated with the property
        - `amount` integer, nullable — Mortgage principal amount in USD
        - `date` string, nullable — Mortgage origination date (YYYY-MM-DD)
        - `due_date` string, nullable — Mortgage maturity date (YYYY-MM-DD)
        - `term` integer, nullable — Mortgage term in months
        - `rate` number, nullable — Interest rate as percentage
        - `rate_type` string, nullable — Rate type (fixed, adjustable)
      - `business_owners` BusinessOwnerDto[] — Business entities that own the property
        - `name` string, required — Business entity name
      - `person_owners` PersonOwnerDto[] — Individuals who own the property
        - `id` string, required — Unique person identifier
        - `name` string, required — Full name of the property owner
        - `current_addresses` AddressDto[] — Current residential addresses
          - `address_id` string, required — Unique address identifier
          - `full_address` string, required — Complete formatted address string
          - `city` string, required — City name
          - `state` string, required — Two-letter state code
          - `line1` string, required — Street address line (house number and street)
          - `zip` string, required — 5-digit ZIP code
        - `phones` PersonPhoneDto[] — Phone numbers associated with the owner
          - `number` string, required — Phone number in E.164 or national format
          - `type` 'Unknown' | 'Mobile' | 'Landline' | 'VOIP' | 'TollFree', required — Phone line type (mobile, landline, voip)
        - `emails` PersonEmailDto[] — Email addresses associated with the owner
          - `email` string, required — Email address
    - `residents` ResidentDto[] — Current residents at the property
      - `id` string, required — Unique person identifier
      - `name` string, required — Full name of the resident
      - `current_addresses` AddressDto[] — Current residential addresses
        - `address_id` string, required — Unique address identifier
        - `full_address` string, required — Complete formatted address string
        - `city` string, required — City name
        - `state` string, required — Two-letter state code
        - `line1` string, required — Street address line (house number and street)
        - `zip` string, required — 5-digit ZIP code
      - `phones` PersonPhoneDto[] — Phone numbers associated with the resident
        - `number` string, required — Phone number in E.164 or national format
        - `type` 'Unknown' | 'Mobile' | 'Landline' | 'VOIP' | 'TollFree', required — Phone line type (mobile, landline, voip)
      - `emails` PersonEmailDto[] — Email addresses associated with the resident
        - `email` string, required — Email address

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Content
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.dev/whitepages/apis/whitepages-api-reference.md) · [All operations](https://skmtc.dev/whitepages/apis/whitepages-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/whitepages/whitepages-api-reference/revisions/c27a0cd8718f/schema)