Parcels

Property-tax delinquency status of a parcel

Whether the parcel is on a treasurer's or tax collector's published property-tax delinquency, lien-sale or tax-sale list (pilot jurisdictions), with each record's status, amount (and what the amount is), tax years, sale, publisher, dates and the list's scope. People data (the owner on the tax bill, its mailing address, certificate holders). An ACCOUNT is served like the owner card: a response that serves records counts as one lookup against the account's monthly cap (included on paid plans) and is written to the people-data access log; at the cap the records are withheld with people_fields.code: lookup_cap_reached (nothing charged). A caller WITHOUT an account may pay per answer ($0.10, maxAmountRequired 100000) with an x402 X-PAYMENT header or an X-CREDIT-TOKEN: the answer (paid_via: x402 | credits) is returned only once the payment settles or the debit succeeds; not_covered and unavailable answers are free (charged: false). An UNPAID caller with no account gets 401 code: account_required and nothing else. Before the layer's first load status is unavailable.

get/api/v1/parcels/{id}/tax-status

Request

  • Base URL: https://propraven.com
  • URL: https://propraven.com/api/v1/parcels/{id}/tax-status
  • Auth: HTTP bearer

Path parameters

idstring required
Example:37:119:12104406

Parcel identifier: the canonical state_fips:county_fips:parcel_id form (e.g. 37:119:12104406), the legacy 5-digit county_fips5:parcel_id form, or a PropRaven parcel UUID. URL-encode it.

Response

The parcel's tax status.

parcel_idstring required
status'listed' | 'not_listed' | 'not_covered' | 'unavailable' required

listed = on at least one unexpired list; not_listed = an unexpired list covers the county and this parcel is not on it (read list_scope: never proof of payment); not_covered = no list for the county; unavailable = the layer could not be read.

truncatedboolean required
notestring required
people_fieldsobject

Present when the records were withheld by the lookup meter: code lookup_cap_reached or lookup_meter_unavailable (nothing charged).

Changes

No recorded changes to this operation across all 1 revision of this API.