Owner card -- the owner of record and their mailing contact (account required)
The owner of record and how to reach them BY MAIL, for one parcel (parcel_id) or one owner name (name, the exact owner-of-record spelling). Returns the co-owners the same assessor record names (co_owners, co_owner_status: listed / none_listed / not_checked) and the best mailing address -- read from ONE address column family of the record, with its ZIP, flagged mail_ready / po_box / equals_situs, graded A-D with its source and as-of date (as_of_basis: roll_year = the record's tax year; release_vintage = the PropRaven parcel release that served a record with no roll year, never presented as the county's date; recording_date = a deed; null when there is no date) -- plus, for an owner name, the owner's distinct mailing addresses across up to 50 of their parcels (parcels_citing). phones are OWNER phones only: a building permit filed in the current owner's era published the phone for the owner role (the field name, the publisher, or a role column on the permit says so) and names the current owner; otherwise phone_status says none_published, or not_checked when the lookup could not run. people_on_permits separately lists applicant and contractor phones from the parcel's permits (role, name, permit, date, and era: filed in the current owner's era or before it); they are never the owner's phone, and a phone whose role the source does not state is never served. Every phone is E.164 with its extension split off and the published value kept verbatim (phone_raw). Grade-D (contradictory) addresses are hidden unless include_low_confidence=true.
ACCOUNT REQUIRED: an API key, an MCP OAuth token or a signed-in session. Anonymous callers -- including x402 / credit-token wallets -- get HTTP 401 code: "account_required" before any read.
LOOKUP CAP: on an account without a paid plan each card counts as ONE lookup against the monthly lookup cap, spent before any read (a card that is not served is refunded). At the cap: HTTP 402 code: "lookup_cap_reached" with used / limit / plan and the upgrade link. Each served card is recorded in PropRaven's people-data access log.
Request
- Base URL: https://propraven.com
- URL: https://propraven.com/api/v1/owners/card
- Auth: HTTP bearer
Query parameters
A canonical id (state:county:parcel) or a parcel UUID. Pass this OR name.
An owner of record, exact spelling (e.g. from a parcel lookup). Pass this OR parcel_id.
true -> also return grade-D (contradictory) addresses.
Response
The owner card.
Changes
No recorded changes to this operation across all 1 revision of this API.