Estimated tax
Plan quarterly estimated income tax from the books and record the payments.
GET /estimated-taxQuarterly estimated income tax for a tax yearPOST /estimated-tax/tax-typeSay how the business is taxedPOST /estimated-tax/plansSave a tax year's estimate planPOST /estimated-tax/paymentsRecord an estimated tax payment and post it to the booksPOST /estimated-tax/payments/{payment_id}/undoTake back a payment recorded by mistake
Quarterly estimated income tax for a tax year
GET /estimated-tax
The business's tax type, the year's plan, profit so far and projected, and for federal and any state line the amount on each basis (this year's profit, last year's tax), the installments with what's owed, and the payments recorded. These are planning figures from the books, not tax advice. Requires reports:read.
Parameters
| Name | In | Type | About |
|---|---|---|---|
year | query | integer | The tax year; defaults to the current one. |
Answers
Say how the business is taxed
POST /estimated-tax/tax-type
Sends Idempotency-Key.
Requires accounts:write. Can't change once payments are recorded under the current type.
Body
| Field | Type | About |
|---|---|---|
tax_classification required | string | One of: c_corporation, s_corporation, partnership, sole_proprietor. |
Answers
Save a tax year's estimate plan
POST /estimated-tax/plans
Sends Idempotency-Key.
Requires journal:write.
Body
| Field | Type | About |
|---|---|---|
tax_year required | integer | |
basis | string | One of: projection, safe_harbor. |
owner_rate | string | Pass-throughs: the owners' federal rate on profit, as a percent. |
expected_profit | string | |
prior_year_federal | string | |
high_income | boolean | |
self_employment_tax | boolean | Sole proprietors and partnerships: add self-employment tax (Social Security up to the year's wage base and Medicare, on 92.35% of each owner's share). It assumes the owners share profit equally and have no other wages subject to Social Security that year, so it's the most the tax would be: an owner with W-2 wages pays less. The response's federal line shows the amount as self_employment_tax, and se_tax_unconfirmed is true when the year's wage base isn't confirmed. |
owners | integer | |
state | string | |
state_rate | string | |
prior_year_state | string | |
payment_account_id | string (uuid) |
Answers
Record an estimated tax payment and post it to the books
POST /estimated-tax/payments
Sends Idempotency-Key.
Requires journal:write.
Body
| Field | Type | About |
|---|---|---|
tax_year required | integer | |
jurisdiction required | string | One of: federal, state. |
installment required | integer | |
paid_on required | string (date) | |
amount required | Amount | |
paid_from_account_id required | string (uuid) | |
note | string | Up to 500 characters. |
Answers
Take back a payment recorded by mistake
POST /estimated-tax/payments/{payment_id}/undo
Sends Idempotency-Key.
Reverses its entry unless the entry is matched to a bank line. Requires journal:write.
Parameters
| Name | In | Type | About |
|---|---|---|---|
payment_id required | path | string (uuid) |

