Property Level

Tax History (Batch)

Review current and historical tax and assessment values, aiding in property valuation and tax planning.

Source: Public Records

Pricing Tier: Basic

Updated: Annually

Request Query Params

<table><tr><th>Property</th><th>Type</th><th>Description</th><th>Example</th><th>Enum Values</th></tr> <tr><td>order</td><td>string</td><td>Chronological order to sort result items</td><td></td> <td>[asc, desc]</td></tr> <tr><td>limit</td><td>integer</td><td>Maximum number of items to return</td><td>10</td> <td></td></tr> <tr><td>start</td><td>string</td><td>Beginning date limit for result items, based on tax_year, in ISO 8601 format, i.e. 2015-01-01. Defaults to null.</td><td>2015-01-01</td> <td></td></tr> <tr><td>end</td><td>string</td><td>Ending date limit for result items, based on tax_year, in ISO 8601 format, i.e. 2015-01-01. Defaults to null.</td><td>2015-01-01</td> <td></td></tr> </table>

Request Body Fields

<table><tr><th>Field</th><th>Type</th><th>Description</th><th>Example</th></tr> <tr><td>[]</td><td>object</td><td></td><td></td> </tr> <tr><td>[].slug</td><td>string</td><td>Unique readable string identifier for the property</td><td>123-Main-St-Apt-1B-San-Francisco-CA-94132</td> </tr> <tr><td>[].address</td><td>string</td><td>Either a single URL-safe string ("slug") identifying the address, or just a building number, street name, and optionally unit number (if not a slug the payload must also include other identifiers)</td><td>123 Main St</td> </tr> <tr><td>[].unit</td><td>string</td><td>Unit number for the property, if needed and not already specified in the address string</td><td>Apt 1B</td> </tr> <tr><td>[].city</td><td>string</td><td>City in which the property is located</td><td>San Francisco</td> </tr> <tr><td>[].state</td><td>string</td><td>2-letter acronym of the US state in which the property is located</td><td>CA</td> </tr> <tr><td>[].zipcode</td><td>string</td><td>5-digit US zipcode in which the property is located</td><td>94105</td> </tr> </table>

Response

<table><tr><th>Field</th><th>Type</th><th>Description</th><th>Example</th></tr> <tr><td>tax_history</td><td>array</td><td></td><td></td> </tr> <tr><td>tax_history[]</td><td>object</td><td></td><td></td> </tr> <tr><td>tax_history[].apn</td><td>string</td><td>Assessor's Parcel Number or Parcel Identification Number</td><td>123-456-789</td> </tr> <tr><td>tax_history[].assessment_year</td><td>integer</td><td>Year the assessment was conducted</td><td>2022</td> </tr> <tr><td>tax_history[].tax_amount</td><td>integer</td><td>Amount in dollars of tax owed on the property</td><td>2500</td> </tr> <tr><td>tax_history[].tax_year</td><td>integer</td><td>Tax year for which the assessment applies</td><td>2022</td> </tr> <tr><td>tax_history[].total_assessed_value</td><td>integer</td><td>The total assessed value of both land and improvements (before exemptions, if any) as reported on the county tax/assessment roll in the indicated year.</td><td>350000</td> </tr> </table>
post/v2/property/tax_history

Query parameters

order'asc' | 'desc' nullable

Chronological order to sort result items

limitinteger nullable

Maximum number of items to return

startstring date nullable

Beginning date limit for result items, based on tax_year, in ISO 8601 format, i.e. 2015-01-01. Defaults to null.

endstring date nullable

Ending date limit for result items, based on tax_year, in ISO 8601 format, i.e. 2015-01-01. Defaults to null.

Request body

slugstring

Unique readable string identifier for the property

addressstring required

Either a single URL-safe string ("slug") identifying the address, or just a building number, street name, and optionally unit number (if not a slug the payload must also include other identifiers)

unitstring

Unit number for the property, if needed and not already specified in the address string

citystring

City in which the property is located

statestring

2-letter acronym of the US state in which the property is located

zipcodestring

5-digit US zipcode in which the property is located

Example request

[
  {
    "slug": "123-Main-St-Apt-1B-San-Francisco-CA-94132",
    "address": "123 Main St",
    "unit": "Apt 1B",
    "city": "San Francisco",
    "state": "CA",
    "zipcode": "94105"
  }
]

Response

Success

Example response

[
  {
    "property/tax_history": {
      "result": {
        "tax_history": [
          {
            "apn": "123-456-789",
            "assessment_year": 2022,
            "tax_amount": 2500,
            "tax_year": 2022,
            "total_assessed_value": 350000
          }
        ]
      }
    },
    "address_info": {
      "address_full": "123 Main St San Francisco CA 94132",
      "slug": "123-Main-St-Apt-1B-San-Francisco-CA-94132",
      "address": "123 Main St",
      "unit": "Apt 1B",
      "city": "San Francisco",
      "state": "CA",
      "zipcode": "94132",
      "zipcode_plus4": "1234",
      "block_id": "060750313013007",
      "blockgroup_id": "060750201004",
      "county_fips": "06075",
      "metrodiv": "41860",
      "msa": "41860",
      "geo_precision": "rooftop",
      "lat": 37.789,
      "lng": -122.401,
      "status": {
        "match": true,
        "details": [
          "Address fully verified"
        ],
        "requested_item": {
          "zipcode": "94132",
          "address": "123+Main+St"
        },
        "changes": [
          "State added or changed"
        ]
      }
    }
  }
]