What you supply
Determination takes one home address and between one and ten work addresses. Those addresses do the heavy lifting; most of what SPF needs to know is derived from them. Three optional inputs adjust the outcome:- Nexus: the states where your company has a business presence and is therefore subject to withholding obligations. Nexus is always assumed in a work state. For a resident state where the employee doesn’t work, you have to tell SPF. If you say nothing, SPF assumes nexus exists in the resident state.
- Lock-in letters: jurisdictions where the IRS has directed the employer to withhold at a specified minimum. A lock-in letter changes which forms and which paths the employee is offered.
- Interstate employee: a flag that fine-tunes outcomes for employees whose home and work states differ, mainly affecting whether certain Colorado and Oregon forms come back as recommended rather than optional.
From address to jurisdiction
An address isn’t a jurisdiction. Turning one into the other is a real step, and for U.S. addresses it’s handled by the Symmetry Location Service.This section is U.S.-only. The Symmetry Location Service does not cover Canada, so Canadian addresses are not resolved to jurisdictions this way. Location data comes back empty for Canadian locations, and nexus and lock-in letters don’t apply. Canadian determination is handled by a separate processor. See the Canadian SPF API overview.
1
Normalize
The address is compared against USPS data and standardized, so
123 main st and 123 Main Street resolve identically.2
Geocode
The normalized address is converted to latitude and longitude coordinates.
3
Match jurisdictions
Taxing jurisdiction shapefile boundaries are overlaid against those coordinates to determine which jurisdictions the location falls within: state, county, city, municipality, and school district.
4
Return jurisdiction data
SPF gets back the jurisdictions that apply, plus jurisdiction-specific data that some forms need to complete themselves.
What comes back
Once jurisdictions are resolved, SPF assembles the form set. In broad terms:- The federal form is in scope by default. You can remove federal forms entirely (and the Federal section of Guided Mode along with them) by setting
disableFederaltotrueinsettings.json, in the SPF Registration JSON, or through the Admin Panel. - The work state’s form applies, unless a reciprocal agreement removes the obligation and replaces it with an exemption certificate.
- The resident state’s form applies when it differs from the work state and that state taxes the wages.
- Local forms are added when the specific city, municipality, or school district imposes its own withholding.
Recommended and optional forms
Not every returned form is mandatory. Each one is marked as recommended or optional. Recommended forms are the ones the employee should complete based on their situation. Optional forms are legitimately available to them but not required: an Oregon transit tax opt-in, for example, or Colorado’s DR 1059, the Affidavit of Exemption for the Nonresident Spouse of a U.S. Servicemember. How you present that distinction is up to you, and it interacts with the mode you’ve chosen. Guided Mode narrows the set through targeted questions; Choose Mode presents the forms and lets the employee decide. See Form modes.Two ways to ask
SPF exposes determination through two paths, and which one you use depends on the experience you’re building.Direct determination
Returns the forms that apply, straight from the addresses. Best when you’re presenting a list for the employee to work through, or when you already know what you need.
Guided flows
Returns one flow per applicable jurisdiction. Some flows resolve to forms immediately; others ask the employee a few questions first (about military spouse status, exemptions, or language preference) to narrow down which form in that jurisdiction is the right one.
Related
Multi-state scenarios
Per-state reference for nexus, reciprocity, and nonresident taxation.
Interstate employees
What the interstate employee flag changes.
Local withholding forms
The local forms SPF supports and the states that require them.
Symmetry Location Service
The address normalization and geocoding service behind determination.

