Estimated tax

Plan quarterly estimated income tax from the books and record the payments.

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

NameInTypeAbout
yearqueryinteger

The tax year; defaults to the current one.

Answers

  • 200 object. The year's estimate.
  • 4XX Problem. An error. `code` is stable and safe to branch on; `detail` says in plain English what
  • 5XX Problem. An error. `code` is stable and safe to branch on; `detail` says in plain English what

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

FieldTypeAbout
tax_classification requiredstring

One of: c_corporation, s_corporation, partnership, sole_proprietor.

Answers

  • 200 object. Saved.
  • 4XX Problem. An error. `code` is stable and safe to branch on; `detail` says in plain English what
  • 5XX Problem. An error. `code` is stable and safe to branch on; `detail` says in plain English what

Save a tax year's estimate plan

POST /estimated-tax/plans

Sends Idempotency-Key.

Requires journal:write.

Body

FieldTypeAbout
tax_year requiredinteger
basisstring

One of: projection, safe_harbor.

owner_ratestring

Pass-throughs: the owners' federal rate on profit, as a percent.

expected_profitstring
prior_year_federalstring
high_incomeboolean
self_employment_taxboolean

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.

ownersinteger
statestring
state_ratestring
prior_year_statestring
payment_account_idstring (uuid)

Answers

  • 200 object. Saved.
  • 4XX Problem. An error. `code` is stable and safe to branch on; `detail` says in plain English what
  • 5XX Problem. An error. `code` is stable and safe to branch on; `detail` says in plain English what

Record an estimated tax payment and post it to the books

POST /estimated-tax/payments

Sends Idempotency-Key.

Requires journal:write.

Body

FieldTypeAbout
tax_year requiredinteger
jurisdiction requiredstring

One of: federal, state.

installment requiredinteger
paid_on requiredstring (date)
amount requiredAmount
paid_from_account_id requiredstring (uuid)
notestring

Up to 500 characters.

Answers

  • 201 object. Recorded.
  • 4XX Problem. An error. `code` is stable and safe to branch on; `detail` says in plain English what
  • 5XX Problem. An error. `code` is stable and safe to branch on; `detail` says in plain English what

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

NameInTypeAbout
payment_id requiredpathstring (uuid)

Answers

  • 200 object. Taken back.
  • 4XX Problem. An error. `code` is stable and safe to branch on; `detail` says in plain English what
  • 5XX Problem. An error. `code` is stable and safe to branch on; `detail` says in plain English what