---
title: "Get parcel owner details and portfolio"
method: GET
path: "/api/v1/parcels/{id}/owner"
tags: ["Parcels"]
---

# Get parcel owner details and portfolio

`GET /api/v1/parcels/{id}/owner`

## Request

- Base URL: `https://propraven.com`
- URL: `https://propraven.com/api/v1/parcels/{id}/owner`
- Auth: HTTP bearer

Retrieve the owner of a parcel along with their portfolio summary and list of properties.

## Path parameters

- `id` string, required

## Response `200`

Owner details returned.

- object
  - `owner` object, required
    - `owner_name` string, nullable, required
    - `owner_address` string, nullable, required
    - `owner_city` string, nullable, required
    - `owner_state` string, nullable, required
  - `contact` object, required
    - `owner_name` string, nullable, required
    - `owner_name_status` string, nullable, required
    - `owner_roles` unknown[], required
      - unknown
    - `owner_name_provenance` object, required
      - `source` object, required
        - `authority` string, nullable, required
        - `dataset` string, nullable, required
        - `url` string, nullable, required
      - `as_of` string, nullable, required
      - `as_of_basis` string, required
      - `grade` string, nullable, required
    - `co_owners` unknown[], required
      - unknown
    - `co_owner_status` string, nullable, required
    - `mailing` object, required
      - `basis` string, nullable, required
      - `line1` string, nullable, required
      - `city` string, nullable, required
      - `state` string, nullable, required
      - `zip5` string, nullable, required
      - `zip4` string, nullable, required
      - `mail_ready` boolean, nullable, required
      - `po_box` boolean, nullable, required
      - `equals_situs` boolean, nullable, required
      - `zip_conflict` boolean, nullable, required
      - `parcels_citing` number, nullable, required
      - `parcels_citing_basis` string, required
      - `label` string, nullable, required
      - `source` object, required
        - `authority` string, nullable, required
        - `dataset` string, nullable, required
        - `url` string, nullable, required
      - `as_of` string, nullable, required
      - `as_of_basis` string, required
      - `grade` string, nullable, required
    - `mailing_alternates` unknown[], required
      - unknown
    - `entity` object, required
      - `entity_type` string, nullable, required
      - `status` string, nullable, required
      - `state_of_formation` string, nullable, required
      - `formation_date` string, nullable, required
      - `registered_agent` string, nullable, required
      - `officers` unknown[], required
        - unknown
      - `source` object, required
        - `authority` string, nullable, required
        - `dataset` string, nullable, required
        - `url` string, nullable, required
      - `as_of` string, nullable, required
      - `as_of_basis` string, nullable, required
      - `grade` string, nullable, required
    - `phones` unknown[], required
      - unknown
    - `phone_status` string, nullable, required
    - `emails` unknown[], required
      - unknown
    - `none_published` string[], required
    - `hidden_low_confidence` number, nullable, required
    - `people_on_permits` unknown[], required
      - unknown
    - `people_on_permits_status` string, nullable, required
    - `other_addresses` object[], required
      - `parcel_id` string, required
      - `state` string, nullable, required
      - `county` string, nullable, required
      - `kind` string, nullable, required
      - `address` object, required
        - `line1` string, nullable, required
        - `city` string, nullable, required
        - `state` string, nullable, required
        - `zip5` string, nullable, required
        - `zip4` string, nullable, required
        - `label` string, nullable, required
        - `mail_ready` boolean, nullable, required
        - `po_box` boolean, nullable, required
      - `same_as` string, nullable, required
      - `grade` string, nullable, required
      - `link` string, nullable, required
      - `basis` string, nullable, required
      - `label_note` string, nullable, required
      - `evidence` unknown[], required
        - unknown
      - `mail_merge` boolean, nullable, required
      - `owner_name_on_record` string, nullable, required
      - `owner_roles` unknown[], required
        - unknown
      - `cited_by` object[], required
        - `parcel_id` string, required
        - `state` string, nullable, required
        - `county` string, nullable, required
      - `parcels_citing` number, nullable, required
      - `source` object, required
        - `authority` string, nullable, required
        - `dataset` string, nullable, required
        - `url` string, nullable, required
      - `as_of` string, nullable, required
      - `as_of_basis` string, required
    - `other_addresses_status` string, nullable, required
    - `other_addresses_scope` object, required
      - `name_basis` string, required
      - `spellings` number, nullable, required
      - `parcels_read` number, nullable, required
      - `capped` boolean, nullable, required
      - `copies_skipped` number, nullable, required
      - `parcels_linked` number, nullable, required
      - `possible_found` number, nullable, required
      - `possible_listed` number, nullable, required
      - `possible_cap` number, nullable, required
      - `possible_withheld_reason` string, nullable, required
      - `listed_capped` boolean, nullable, required
      - `evidence_providers` object[], required
        - `id` string, required
        - `status` string, nullable, required
      - `co_owner_link` string, nullable, required
  - `entity_type` string, nullable, required: Observed values include: CORP.
  - `portfolio` object, required
    - `property_count` integer, nullable, required
    - `state_count` integer, nullable, required
    - `total_assessed_value` integer, nullable, required
    - `total_acreage` number, nullable, required
    - `states_list` string, nullable, required
    - `county_count` integer, nullable
    - `portfolio_rank` integer, nullable
  - `properties` object[], required
    - `parcel_id` string, required
    - `county_fips` string, required
    - `state_fips` string, required
    - `address` string, nullable, required
    - `city` string, nullable, required
    - `state` string, nullable, required
    - `zip` string, nullable, required
    - `total_assessed_value` number, nullable, required
    - `last_sale_price` number, nullable, required
    - `last_sale_date` string, nullable, required
    - `property_type` string, nullable, required
    - `building_sqft` number, nullable, required
    - `lot_size_acres` number, nullable, required
    - `year_built` integer, nullable, required
  - `owner_name` string
  - `mailing_address` string
  - `portfolio_summary` object
    - `property_count` integer
    - `total_assessed_value` number
    - `states` string[]

## Other responses

- `400`: A query or body parameter is invalid. Nothing was read or charged.
- `401`: Missing, malformed or invalid credential.
- `404`: The resource (or the endpoint) does not exist.
- `405`: The endpoint exists but does not support this method. `Allow` lists the methods it does.
- `429`: Rate limit exceeded.
- `500`: Unexpected server error. The body never carries database or driver text.

---

[API](https://skmtc.dev/propraven/apis/propraven-api.md) · [All operations](https://skmtc.dev/propraven/apis/propraven-api/llms.txt) · [OpenAPI document](https://skmtc.dev/propraven/apis/propraven-api/revisions/37f8158c4eda?raw)
