Taxable Location Object

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)
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

{
  "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
}