| team | Yes | Team code, such as BOS. | |
| salary | No | One season total in whole dollars, taxed entirely as duty-day pay. Leave this out when sending base_salary. | |
| season_id | No | Schedule season as eight digits, such as 20252026. Defaults to the latest season for the league when omitted. | |
| base_salary | No | Duty-day base in whole dollars before signing and performance bonuses. Send this with the bonus fields to match Salary + Bonuses. Leave it out when sending salary. | |
| agent_fee_pct | No | Agent fee as a percent of gross pay (0-10), treated as a non-deductible cost. Default 0. | |
| birth_country | No | Birth country code used with is_us_person. | |
| filing_status | No | Single or Married_Joint. Defaults to Single when omitted. | |
| signing_bonus | No | Signing bonus in whole dollars. The site adds this into the season total. On NFL it also includes other inducement pay. | |
| contract_season | No | Contract season label, such as 2025-26. | |
| primary_domicile | No | Resident tax home: a state, a city, or a mode such as local_jurisdiction. Defaults to local_jurisdiction when omitted. | |
| rca_contribution | No | Salary deferred into a Retirement Compensation Arrangement by a Canadian club, in USD. Excluded from Canadian employment income until paid out: from worldwide income for a Canadian resident and in full from Canadian-source pay for a non-resident (Martin v. The King, 2024 TCC 153). US tax is unchanged. Not applied for US clubs. Comparisons count it after the estimated tax at payout (see rca_payout_tax_rate). Default 0. | |
| performance_bonus | No | Performance bonus in whole dollars. Included in the total only when include_performance_bonus_in_jock_tax is true. | |
| rca_payout_tax_rate | No | Estimated tax on the RCA when it is paid out, as a percent (0-100). Default models a player who retires to a no-tax US state and draws the RCA and its refundable tax account down at once: the US-duty-day share, already taxed by the US when contributed, bears Canada's 25% non-resident withholding, and the rest bears the US federal marginal rate on it (37% for a high earner). For a US person, who pays US tax on the whole contribution now, the default is the 25% withholding alone. Lowers net_pay.net_economic, which comparisons match on. | |
| retirement_catch_up | No | none (default), 50_plus (+$8,000) or 60_to_63 (+$11,250). Catch-up contributions are always Roth for athletes (prior-year FICA wages over $150,000). | |
| include_payroll_taxes | No | Opt in to employee payroll taxes for each team's employer: FICA (Social Security, Medicare, Additional Medicare) and the home state's disability or paid-leave levy for US clubs; CPP/QPP, EI and QPIP for Canadian clubs. Default false. For a Canadian resident it also applies the CPP/QPP and EI credits and the enhanced CPP/QPP deduction on the Canadian return. With any take-home option set, the response adds net_pay (net = cash take-home, net_economic = net plus the 401(k) deferral), agent_fee, retirement_contribution, and payroll_taxes when payroll is on. amounts.total stays income tax only. | |
| art_xvi4_inducement_sb | No | Opt in to Canada–U.S. Treaty Art. XVI(4) on an exempt signing bonus from a Canadian club. | |
| estimated_playoff_games | No | Extra postseason games. Use 0 when there are none. | |
| retirement_contribution | No | Annual retirement contribution in USD. On a US club it is a 401(k) elective deferral capped at the 2026 limit ($24,500 plus catch-up). On a Canadian club it is an RRSP contribution capped at C$33,810, deducted from Canadian taxable income only. Default 0. | |
| retirement_contribution_type | No | 401(k) only: pretax (default) lowers income-tax wages except in Pennsylvania, Philadelphia, Pittsburgh, Ohio cities, Kansas City and St. Louis; roth lowers nothing. RRSP contributions are always deductible. | |
| exempt_signing_bonus_from_jock_tax | No | When true, the signing bonus is taxed in the player's domicile and left out of duty-day allocation. | |
| include_performance_bonus_in_jock_tax | No | When true, performance_bonus is part of the season total and of duty-day pay. | |