Skip to main content
GET
/
api
/
v1
/
state-income
State Income
curl --request GET \
  --url https://api.example.com/api/v1/state-income
{
  "year": 2025,
  "employmentType": "w2",
  "taxHomeState": "TN",
  "totalStates": 2,
  "totalStateIncome": 4680000,
  "totalStateTax": 156000,
  "totalDays": 182,
  "states": [
    {
      "state": "TX",
      "stateName": "Texas",
      "income": 2340000,
      "tax": 0,
      "effectiveRate": 0,
      "noTax": true,
      "days": 91,
      "reciprocity": { "exempt": false, "reason": null },
      "stateDeduction": null,
      "filingRequired": false,
      "isHomeState": false,
      "formName": null,
      "formDescription": null,
      "filingDeadline": null,
      "assignments": [
        {
          "id": 1,
          "facility": "Memorial Hospital",
          "location": "Houston",
          "startDate": "2025-01-06",
          "endDate": "2025-04-06",
          "weeks": 13,
          "days": 91,
          "income": 2340000
        }
      ]
    }
  ]
}
Returns per-state income allocation, tax calculations, days worked, reciprocity status, and filing requirements.

​
Query Parameters

​
year
string
default:"current year"
Tax year (YYYY format).

​
Response

{
  "year": 2025,
  "employmentType": "w2",
  "taxHomeState": "TN",
  "totalStates": 2,
  "totalStateIncome": 4680000,
  "totalStateTax": 156000,
  "totalDays": 182,
  "states": [
    {
      "state": "TX",
      "stateName": "Texas",
      "income": 2340000,
      "tax": 0,
      "effectiveRate": 0,
      "noTax": true,
      "days": 91,
      "reciprocity": { "exempt": false, "reason": null },
      "stateDeduction": null,
      "filingRequired": false,
      "isHomeState": false,
      "formName": null,
      "formDescription": null,
      "filingDeadline": null,
      "assignments": [
        {
          "id": 1,
          "facility": "Memorial Hospital",
          "location": "Houston",
          "startDate": "2025-01-06",
          "endDate": "2025-04-06",
          "weeks": 13,
          "days": 91,
          "income": 2340000
        }
      ]
    }
  ]
}
​
states[].reciprocity
object
Reciprocity agreement status.
​
states[].stateDeduction
object
W-2 state deduction detail for qualifying states (NY, CA, AL, HI, AR). null for non-qualifying states or 1099 users.