Taxable Location Object

The Taxable Location Object represents a US address that describes its suitability for use as a work location or residency.

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

Address can accept mail and delivery

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