Skip to main content
GET
/
api
/
v1
/
assignment-profitability
Assignment Profitability
curl --request GET \
  --url https://api.example.com/api/v1/assignment-profitability
{
  "year": 2025,
  "employmentType": "w2",
  "averageNetProfit": 1850000,
  "averageProfitMargin": 0.62,
  "totalNetProfit": 3700000,
  "assignments": [
    {
      "assignmentId": 1,
      "facility": "Memorial Hospital",
      "location": "Houston",
      "state": "TX",
      "agency": "TravelNurse Inc",
      "weeks": 13,
      "grossComp": 2955800,
      "taxableIncome": 2340000,
      "housingStipend": 175000,
      "mieStipend": 54600,
      "bonuses": 100000,
      "federalTax": 280000,
      "stateTax": 0,
      "seTax": 0,
      "totalTax": 280000,
      "linkedExpenses": 45000,
      "linkedMiles": 850,
      "linkedMileageDeduction": 59500,
      "netProfit": 2630800,
      "profitMargin": 0.89
    }
  ]
}
Calculates net profit for each assignment, proportionally allocating federal tax across assignments to avoid bracket distortion.

​
Query Parameters

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

​
Request

curl -H "Authorization: Bearer <token>" \
  "https://app.taxhomebase.com/api/v1/assignment-profitability?year=2025"

​
Response

{
  "year": 2025,
  "employmentType": "w2",
  "averageNetProfit": 1850000,
  "averageProfitMargin": 0.62,
  "totalNetProfit": 3700000,
  "assignments": [
    {
      "assignmentId": 1,
      "facility": "Memorial Hospital",
      "location": "Houston",
      "state": "TX",
      "agency": "TravelNurse Inc",
      "weeks": 13,
      "grossComp": 2955800,
      "taxableIncome": 2340000,
      "housingStipend": 175000,
      "mieStipend": 54600,
      "bonuses": 100000,
      "federalTax": 280000,
      "stateTax": 0,
      "seTax": 0,
      "totalTax": 280000,
      "linkedExpenses": 45000,
      "linkedMiles": 850,
      "linkedMileageDeduction": 59500,
      "netProfit": 2630800,
      "profitMargin": 0.89
    }
  ]
}
​
averageNetProfit
integer
Average net profit across all assignments (cents).
​
averageProfitMargin
number
Average profit margin as a decimal (0–1).
​
assignments[].federalTax
integer
Proportionally allocated federal tax for this assignment (cents). Total federal tax is computed once, then divided by each assignment’s share of total income.
​
assignments[].netProfit
integer
grossComp - totalTax - linkedExpenses (cents).
​
assignments[].profitMargin
number
netProfit / grossComp as a decimal.