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
}

Introduction

Webhooks

Zeal Components

Companies

Company Onboarding

Reserve Accounts

Customer Accounts (Early Access)

Taxable Locations

Work Locations

Employees

Employee Deduction Templates

Employee Onboarding

Bank Accounts

Custom Attributes

Paperwork API

Employee Checks

Contractors

Contractor Onboarding

Contractor Payment Deductions

Payment Items

Contractor Payments

Paycards

Instant Pay

Employer Checks

Preview

Embedded HR

Reports

Documents

Taxable Location Object