Skip to main content
GET
Get the tax set-aside estimate
Preview. A contract we are building with design partners. It is not callable yet, and fields can still change. See Availability.
Built for a “tax pot” in a business account: refresh it after each new movement, invoice or expense. An estimate is not a return and has no approval.

Authorizations

Authorization
string
header
required

Your partner secret key, mk_live_… for real companies or mk_test_… for test companies. Keep it on your servers. See Authentication.

Path Parameters

company_id
string<uuid>
required

The company's ID. Every company-scoped call works in exactly this company.

Query Parameters

period
string
required

A quarter such as 2026-Q4, or a year such as 2026 for every quarter of it. A year (2026), a quarter (2026-Q3), a month (2026-09) or an instalment (2026-1P).

Pattern: ^[0-9]{4}(-Q[1-4]|-(0[1-9]|1[0-2])|-[1-3]P)?$
Example:

"2026-Q3"

Response

The estimate.

period
string
required

A year (2026), a quarter (2026-Q3), a month (2026-09) or an instalment (2026-1P).

Pattern: ^[0-9]{4}(-Q[1-4]|-(0[1-9]|1[0-2])|-[1-3]P)?$
Example:

"2026-Q3"

as_of
string<date-time>
required
set_aside_total
string
required

The sum to keep aside for the returns that have a payment. Refunds and offsets do not reduce it.

Pattern: ^-?[0-9]+\.[0-9]{2}$
Example:

"121.00"

items
object[]
required
review
string[]

What makes the estimate less certain.