API referencellms.txt
Estimates
What a taxpayer owes for a quarter, federal and state.
Create an estimate
POST
/v1/estimatesCreates or updates the estimate for that taxpayer and quarter.
Fields
taxpayer_idstringRequired- The taxpayer, like
tp_8Kq2. quarterstringRequired- Which quarter, like
2026-Q4. income_ytdintegerRequired- Income so far this year, in cents.
expenses_ytdinteger- Business expenses so far this year, in cents.
withholding_ytdinteger- Tax already withheld from any W-2 job, in cents.
prior_year_taxinteger- Last year’s total tax, for the safe-harbor minimum.
curl -X POST "https://api.workmade.com/v1/estimates" \ -H "Authorization: Bearer $WORKMADE_KEY" \ -H "Content-Type: application/json" \ -d '{ "taxpayer_id": "tp_8Kq2", "quarter": "2026-Q4", "income_ytd": 8420000, "expenses_ytd": 1265000 }'
{
"id": "est_5Hv2",
"object": "estimate",
"taxpayer_id": "tp_8Kq2",
"quarter": "2026-Q4",
"due": "2027-01-15",
"federal": {
"form": "1040-ES",
"amount": 418000
},
"state": {
"code": "NY",
"form": "IT-2105",
"amount": 126500,
"due": "2027-01-15"
},
"total": 544500,
"safe_harbor": {
"method": "prior_year_100",
"minimum": 418000
},
"created": "2026-10-26T14:22:05Z"
}Retrieve a quarter
GET
/v1/taxpayers/tp_8Kq2/quarters/2026-Q4Everything about one quarter: owed, saved, and the payments.
curl "https://api.workmade.com/v1/taxpayers/tp_8Kq2/quarters/2026-Q4" \ -H "Authorization: Bearer $WORKMADE_KEY"
{
"object": "quarter",
"taxpayer_id": "tp_8Kq2",
"quarter": "2026-Q4",
"due": "2027-01-15",
"total": 544500,
"saved": 544500,
"ready_to_pay": true,
"payments": [
{
"id": "pay_7Hc1",
"agency": "IRS",
"amount": 418000,
"status": "scheduled"
},
{
"id": "pay_7Hc2",
"agency": "NY",
"amount": 126500,
"status": "scheduled"
}
]
}POSTCreate an estimate
curl -X POST "https://api.workmade.com/v1/estimates" \ -H "Authorization: Bearer $WORKMADE_KEY" \ -H "Content-Type: application/json" \ -d '{ "taxpayer_id": "tp_8Kq2", "quarter": "2026-Q4", "income_ytd": 8420000, "expenses_ytd": 1265000 }'
{
"id": "est_5Hv2",
"object": "estimate",
"taxpayer_id": "tp_8Kq2",
"quarter": "2026-Q4",
"due": "2027-01-15",
"federal": {
"form": "1040-ES",
"amount": 418000
},
"state": {
"code": "NY",
"form": "IT-2105",
"amount": 126500,
"due": "2027-01-15"
},
"total": 544500,
"safe_harbor": {
"method": "prior_year_100",
"minimum": 418000
},
"created": "2026-10-26T14:22:05Z"
}Was this page helpful?