The Taxable Location Object represents a U.S.-based address that describes its suitability for use as a work location or residency.

> **Note:** Zeal utilizes a third-party validation tool to ensure a provided address is valid and mail-deliverable.

| attribute | type | description |
| --- | --- | --- |
| taxableLocationID | string | Unique identifier representing this address |
| street1 | string | Address Line 1 (Street name) |
| street2 | string | Address Line 2(Apt/Suite). Empty string if not applicable |
| city | string | City/Subdivision |
| state | string | US State or Territory (2-letter abbreviation, see [ANSI](https://www.census.gov/library/reference/code-lists/ansi/ansi-codes-for-states.html)) |
| zip | string | ZIP code (5 digits) |
| is_suitable_for_taxation | boolean | Flag indicating whether a location is suitable for use as a work location and/or residency. If false, one or more of the following flags will be set. |
| is_po_box | boolean | PO Box addresses are mailing addresses but are not suitable for taxation |
| is_state_mismatch | boolean | An address's resolved geo-location must match the specified state or it is considered unsuitable for taxation |
| is_armed_forces_address | boolean | Armed Forces (APO/FPO/DPO) addresses are suitable for mailing but not for taxation purposes. Use the employee's last US address for residency purposes. |
| is_foreign_address | boolean | Foreign addresses are suitable for mailing but not for taxation purposes |
| is_deliverable | boolean | The address can accept mail and delivery |

EXAMPLE SUITABLE TAXABLE LOCATION OBJECT

```json
{
  "taxableLocationID": "609ffdf81a5f9c4c10b0c443",
  "street1": "1 Ferry Building",
  "street2": "",
  "city": "San Francisco",
  "state": "CA",
  "zip": "94111",
  "is_suitable_for_taxation": true,
  "is_po_box": "false",
  "is_state_mismatch": false,
  "is_armed_forces_address": false,
  "is_foreign_address": false
}
```