---
title: "Search property owners"
method: GET
path: "/api/v1/owners/search"
tags: ["Owners"]
---

# Search property owners

`GET /api/v1/owners/search`

## Request

- Base URL: `https://propraven.com`
- URL: `https://propraven.com/api/v1/owners/search`
- Auth: HTTP bearer

Search for property owners by name. Returns owner profiles with property counts and portfolio values.

## Query parameters

- `q` string, required
- `min_properties` integer
- `limit` integer

## Response `200`

Owner search results returned.

- object
  - `data` Owner[], required
    - `owner_name_normalized` string, nullable, required
    - `property_count` integer, nullable, required
    - `state_count` integer, nullable, required
    - `county_count` integer, nullable, required
    - `total_assessed_value` number, nullable, required
    - `avg_assessed_value` number, nullable, required
    - `total_acreage` number, nullable, required
    - `states_list` union, required
      - number
      - string
    - `portfolio_rank` integer, nullable, required
    - `entity_type` string, nullable: Observed values include: CORP.
    - `is_pe_aggregator` boolean, nullable
    - `is_entity_owned` boolean, nullable
    - `pe_parent_group` string, nullable
    - `pe_sponsor` string, nullable
    - `pe_confidence` number, nullable
    - `owner_entity_type` string, nullable
    - `is_absentee` boolean, nullable
    - `contact_card` string, nullable
    - `owner_name` string
    - `states` string[]
  - `count` integer, required

## Other responses

- `400`: A query or body parameter is invalid. Nothing was read or charged.
- `401`: Missing, malformed or invalid credential.
- `402`: Monthly call cap reached (free tier, or a paid tier with the hard cap enabled).
- `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.
- `504`: The query did not finish in time. Retry after `Retry-After` seconds or narrow the request.

---

[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)