Skip to content

Properties

To get information about a specific tax, you can use the following endpoint:

where <name> is the name of the tax and <parameters> is an optional query string.

The following parameters are available:

ParameterDescription
paydateThe check date in the format YYYY-mm-dd. Default is the current date.
fieldThe specific field to return. Default is all fields.

Field names are:

FieldDescriptionType
nametax namestring
titletax titlestring
taxtypetax type - F, S, L, O, or P (see Tax names)string
publishedDate tax published by Caliber Technology—may be emptystring
effective_dateDate tax goes became effective—may be emptystring
withheldTrue if withheld from employee payboolean
rounding_requiredTrue if tax calculation must be roundedboolean
rounding_optionalTrue if tax calculation can be roundedboolean
has_taxTrue if tax existsboolean
nonresidentTrue if tax only applies to nonresidentsboolean
exemptions_instructionsDescription of value required in the exemptions field, suitable as help text for a user-facing formstring
stateexemptions_instructionsDescription of value required in the stateexemptions field, suitable as help text for a user-facing formstring
stateexemptions_tagBrief description of the stateexemptions field, suitable as a label on a user-facing formstring
miscellaneous_instructionsDescription of value required in the miscellaneous field, suitable as help text for a user-facing formstring
miscellaneous_tagBrief description of the miscellaneous field, suitable as a label on a user-facing formstring
auxiliary_instructionsDescription of value required in the auxiliary field, suitable as help text for a user-facing formstring
auxiliary_tagBrief description of the auxiliary field, suitable as a label on a user-facing formstring
psdTax identifier required for OH and PA W-2 reportinginteger

Examples

For example, to list all properities for the ‘CA’ tax:

To retrieve the effective date for the “AL Fairfield” tax: