# Data rules

{% hint style="danger" %}
*Data quality is very important to us. If you identify any discrepancies in the data that contradict the following data rules, please promptly reach out to Kira Morin at <kmorin@innovatememphis.com> or* [*submit a bug here*](https://datamidsouth.featurebase.app/?b=68139867e57583f1f5451d95)*.*&#x20;
{% endhint %}

<details>

<summary>Ownership</summary>

**Property owner data** are sourced from the **Shelby County Assessor’s Certified Roll,** which is published each May/June.&#x20;

<table data-full-width="true"><thead><tr><th width="189" valign="top">Metric / Indicator</th><th>Logic</th></tr></thead><tbody><tr><td valign="top"><p><strong>Owner Occupied</strong></p><p><br>Flag that identifies if the owner likely resides at that location  (<code>Y</code> / <code>N</code>) </p></td><td><p>Parcels are considered owner-occupied (<code>Y</code>) if they meet any of the following criteria:</p><p></p><p><strong>A</strong>. <strong>Exact address match* + living units:</strong></p><ul><li>The standardized property address* is the same as the owner’s standardized mailing address</li><li>The parcel has at least one living unit</li><li>The owner name does <em>not</em> include words or titles that are common in corporate entities (e.g. LLC, INC, etc.)</li></ul><p><strong>B</strong>. <strong>Exact address match* + residential class:</strong> </p><ul><li>The standardized property address* is the same as the owner’s standardized mailing address*</li><li>The land‑use code combination is a residential category (i.e. single‑family, condos, duplexes, etc.)</li></ul><p><strong>C. Homeowners Association name:</strong> </p><ul><li>Owner name contains keywords like “Homeowners,” “Condo,” etc.</li></ul><p></p><p>All other parcels are not considered owner-occupied (<code>N</code>)</p></td></tr><tr><td valign="top"><p><strong>Owner Type</strong><br></p><p>Categorizes owner into buckets based on owner name and owner-occupied flag (<code>Institutional</code>/ <code>Company</code>/ <code>Individual/Other</code>)</p></td><td><p><strong>Institutional</strong>: </p><ul><li>Property is not owner-occupied</li><li>Owner name matches a known public agency, religious institution <em>or</em> homeowners association</li></ul><p><br><strong>Company</strong>: </p><ul><li>Property is not owner-occupied</li><li>Owner name includes terms related to private or corporate business (LLC, INC, PROPERTIES, INVESTMENT, GROUP, etc.)</li></ul><p></p><p><strong>Individual/Other</strong>: </p><ul><li>Everything else (including true individuals and unrecognized names)</li></ul></td></tr><tr><td valign="top"><p><strong>Investor Owned</strong><br></p><p>Flags individuals and organizations that own residential properties they don’t live in as investors  (<code>Y</code> / <code>N</code>) based on property class, number of living units, and owner type</p></td><td><p>Properties are considered <strong>investor-owned</strong> (<code>Y</code>) if they meet any of the following criteria:</p><p></p><p><strong>A. Residential + not owned by Institution</strong></p><ul><li>Property is not owner‑occupied</li><li>Property has at least one living unit (or has a residential land use code or class)</li><li>Owner type is <strong>not Institutional</strong></li></ul><p></p><p><strong>B. Residential + owned by Company</strong> </p><ul><li>Property owner is a company</li><li>Property has at least one living unit (or a residential property class or code)</li></ul><p></p><p><strong>C. Residential mobile home</strong> </p><ul><li>Property is a mobile home with living units</li><li>Property is not owner‑occupied</li></ul><p></p><p>All other properties are <strong>not</strong> considered investor-owned (<code>N</code>)</p></td></tr><tr><td valign="top"><p><strong>Owner Location</strong></p><p><br>Categorizes the property owner as <code>Local</code> / <code>Non‑local</code> based on their mailing address and the property's mailing address</p></td><td><p><strong>Local</strong> if either:</p><ul><li>The owner’s city name matches the legal town name of the parcel</li><li>The owner’s city is in the nine‑jurisdiction “Memphis metro” list</li></ul><p><strong>Non‑Local</strong> otherwise</p></td></tr><tr><td valign="top"><p><strong>Owner Geography</strong></p><p><br>Categorizes where the property owner lives based on <code>Owner Location</code>  and state and ZIP code from their mailing address (<code>Neighborhood</code> / <code>City</code> / <code>Suburban</code> / <code>In-State</code> / <code>Out-of-State</code>)</p></td><td><p></p><p><strong>Neighborhood</strong>: </p><ul><li>The owner location is Local </li><li>the owner’s mailing address zip code matches the property address zip code</li></ul><p></p><p><strong>City</strong>: </p><ul><li>Neighborhood criteria above not met</li><li>The owner location is Local </li><li>Owner’s mailing address city is “MEMPHIS”</li></ul><p></p><p><strong>Suburban</strong>: </p><ul><li>Neighborhood or City criteria above not met</li><li>The owner location is Local AND in one of the other eight metro cities that is not Memphis</li></ul><p></p><p><strong>In‑State</strong>: </p><ul><li>Neighborhood, City, or Suburban criteria above not met </li><li>The owner location is Non‑Local AND the owner state is Tennessee</li></ul><p></p><p><strong>Out‑of‑State</strong>: </p><ul><li>Does not meet the criteria for any of the other Owner Geography categories above</li></ul></td></tr></tbody></table>

\*To ensure consistency and enable reliable comparisons, Innovate Memphis employs a proprietary address‑standardization process that normalizes both property and owner mailing addresses into a uniform format.&#x20;

</details>

<details>

<summary>Eviction</summary>

Innovate Memphis pulls eviction filings daily from **Shelby County General Sessions Court.** Each extract includes all filings from the previous 90 days to capture any records entered late due to data‑entry delays.\* A scheduled refresh occurs in the Memphis Property Hub on a monthly basis.&#x20;

\*Because the court staff may enter filings up to 90 days after the actual filing date, our extracts include a 90‑day lookback to ensure no records are missed.

<table data-full-width="true"><thead><tr><th width="245.66668701171875" valign="top">Metric / Indicator</th><th>Logic</th></tr></thead><tbody><tr><td valign="top"><p><strong>Eviction in Past 6 Months</strong></p><p><br>Calculates how many eviction filings a property has had in the last six months on a rolling basis. </p></td><td><p>For each parcel, </p><ul><li>Counts any eviction filing dates that occurred between today’s date and six months ago based on Shelby County General Sessions Court records** </li><li>Properties with at least one eviction during this window are included in the ‘<strong>Recent Eviction</strong>’ filter</li></ul></td></tr><tr><td valign="top"><p><strong>Eviction in Past 1 Year</strong> </p><p></p><p>Calculates how many eviction filings a property has had in the last twelve months on a rolling basis.</p></td><td><p>For each parcel, </p><ul><li>Uses a similar calculation as Evictions in the Past 6 months, but with a 12-month window**</li></ul></td></tr><tr><td valign="top"><p><strong>Total Evictions</strong> </p><p></p><p>The total number of evictions cases ever filed for a property between January 2016 and last month.</p></td><td><p>For each parcel,</p><ul><li>Counts every eviction filing <code>Case ID</code> for the property regardless of date.</li></ul></td></tr></tbody></table>

*\*\*Note that administrative data entry may be delayed up 90 days, impacting the accuracy of this metric. Work to modernize processes at General Sessions Court is already underway.*&#x20;

</details>

<details>

<summary>Occupancy</summary>

Unoccupied or vacant properties refers to parcels with vacant built structures  (e.g. homes, storefronts, and warehouses), not vacant land or vacant lots.&#x20;

Innovate Memphis acquires **U.S. Postal Service vacancy data** from **Regrid** on a quarterly schedule. We then calculate each property’s continuous vacancy duration starting in April 2024\*\* and use that value as the basis for short or long term vacancy.&#x20;

<table data-full-width="true"><thead><tr><th width="245.66668701171875" valign="top">Metric / Indicator</th><th>Logic</th></tr></thead><tbody><tr><td valign="top"><p><strong>Vacant Since (at least)</strong></p><p></p><p>The earliest date in our available data* that a property has been continuously vacant. </p></td><td><p>For each parcel, </p><ul><li>Reports the earliest date available that a property was flagged as vacant AND has not been flagged as occupied on any consecutive US Postal Service quarterly report since then</li><li>Only includes properties that were still flagged as vacant by the US Postal Service on the most recent quarterly report</li></ul><p></p><p><em>*Continuous data only goes back to April 2024 - many properties have been vacant for longer.</em></p></td></tr><tr><td valign="top"><p><strong>Months Vacant</strong></p><p></p><p>Calculates how long (in whole months) a property has been continuously vacant.</p></td><td><p>For each parcel, </p><ul><li>Calculates the number of months between the earliest time* the property was flagged as vacant and the date on the most recent quarterly report.</li><li>Assumes properties remained vacant between quarterly reports</li></ul><p></p><p><em>*Continuous data only goes back to April 2024 - many properties have been vacant for longer.</em></p></td></tr><tr><td valign="top"><strong>Vacant</strong><br><br>An indicator of occupancy (<code>Y/N</code>)  based on months vacant. </td><td><p>For each parcel,</p><ul><li>If a property has a value of one or more <code>Months Vacant</code>, then it is considered vacant (<code>Y</code>)</li><li>Otherwise, it is not considered vacant (<code>N</code>)</li></ul></td></tr><tr><td valign="top"><p><strong>Long Term Vacancy</strong></p><p></p><p>A flag marking properties that have been continuously vacant for at least 9 months.</p></td><td><p>For each parcel,</p><ul><li>Property still flagged as vacant by the US Postal Service on the most recent quarterly report AND has been continuously vacant for at least 9 months (<code>Y</code>)</li><li>Otherwise, it is not considered a Long Term Vacancy (<code>N</code>)</li></ul></td></tr></tbody></table>

\*\*If you have USPS Vacancy data from July 2023 to January 2024, please contact Kira Morin at <kmorin@innovatememphis.com>.

</details>

<details>

<summary>Vacant Land</summary>

Land Use Code data indicating vacant land is provided by the **Shelby County Assessor's Certified Roll** on an annual basis in May/June.&#x20;

<table data-full-width="true"><thead><tr><th width="245.66668701171875" valign="top">Metric / Indicator</th><th>Logic</th></tr></thead><tbody><tr><td valign="top"><strong>Vacant Land</strong><br><br>An indicator of undeveloped land (<code>Y/N</code>)  based on land use code. </td><td><p>For each parcel,</p><ul><li>If the land use code on file with the Shelby County Assessor’s Office is equal to <code>000</code> or “Vacant Land"  then it is considered Vacant Land (<code>Y</code>). </li><li>Otherwise, it is not considered vacant land (<code>N</code>)</li></ul></td></tr></tbody></table>

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.datamidsouth.org/data-midsouth-portal/data-reference/data-rules.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
