Skip to main content
POST
/
api
/
v1
/
tax-calculate
Calculate (Contract Compare)
curl --request POST \
  --url https://api.example.com/api/v1/tax-calculate \
  --header 'Content-Type: application/json' \
  --data '
{
  "contracts": [
    {}
  ],
  "employmentType": "<string>",
  "year": 123
}
'
{
  "year": 2025,
  "results": [
    {
      "grossTaxable": 2340000,
      "bonuses": 100000,
      "stipendTotal": 2955000,
      "federalTax": 280000,
      "stateTax": 0,
      "seTax": 0,
      "netTaxable": 2060000,
      "livingCost": 1150000,
      "takeHome": 3865000,
      "noTaxState": true
    }
  ]
}
Calculates the tax impact for one or two contracts, used by the Compare feature. Accepts hypothetical contract data (not tied to saved assignments).

​
Request Body

​
contracts
array
required
Array of 1–2 contract objects. Each requires:
  • basePay (integer, cents) — Weekly base pay
  • state (string) — 2-letter state code
  • weeks (integer) — Contract length
  • housingStipend (integer, cents, optional)
  • mieStipend (integer, cents, optional)
  • signOnBonus (integer, cents, optional)
  • completionBonus (integer, cents, optional)
  • referralBonus (integer, cents, optional)
​
employmentType
string
default:"w2"
w2 or 1099.
​
year
integer
default:"current year"
Tax year.

​
Response

{
  "year": 2025,
  "results": [
    {
      "grossTaxable": 2340000,
      "bonuses": 100000,
      "stipendTotal": 2955000,
      "federalTax": 280000,
      "stateTax": 0,
      "seTax": 0,
      "netTaxable": 2060000,
      "livingCost": 1150000,
      "takeHome": 3865000,
      "noTaxState": true
    }
  ]
}
​
results[].livingCost
integer
Estimated living cost based on HUD Fair Market Rent for the contract location (cents).
​
results[].takeHome
integer
grossTaxable + stipendTotal - totalTax - livingCost (cents).