Get the tax set-aside estimate
curl --request GET \
--url https://api.melso.ai/v1/companies/{company_id}/tax-estimates \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.melso.ai/v1/companies/{company_id}/tax-estimates"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.melso.ai/v1/companies/{company_id}/tax-estimates', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"period": "2026-Q4",
"as_of": "2026-11-03T08:00:00Z",
"set_aside_total": "3142.55",
"items": [
{
"model": "303",
"period": "2026-Q4",
"amount": "2210.40",
"deadline": "2027-01-30",
"basis": "records_to_date"
},
{
"model": "130",
"period": "2026-Q4",
"amount": "932.15",
"deadline": "2027-01-30",
"basis": "records_to_date"
}
],
"review": [
"expenses_without_vat_rate"
]
}{
"error": "invalid token",
"code": "unauthorized",
"request_id": "req_01JAB3K9X2"
}{
"error": "invoice not found",
"code": "not_found",
"request_id": "req_01JAB3K9X2"
}Tax estimates
Get the tax set-aside estimate
What the company’s records so far imply for the returns of a period, and the total to set aside.
GET
/
companies
/
{company_id}
/
tax-estimates
Get the tax set-aside estimate
curl --request GET \
--url https://api.melso.ai/v1/companies/{company_id}/tax-estimates \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.melso.ai/v1/companies/{company_id}/tax-estimates"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.melso.ai/v1/companies/{company_id}/tax-estimates', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"period": "2026-Q4",
"as_of": "2026-11-03T08:00:00Z",
"set_aside_total": "3142.55",
"items": [
{
"model": "303",
"period": "2026-Q4",
"amount": "2210.40",
"deadline": "2027-01-30",
"basis": "records_to_date"
},
{
"model": "130",
"period": "2026-Q4",
"amount": "932.15",
"deadline": "2027-01-30",
"basis": "records_to_date"
}
],
"review": [
"expenses_without_vat_rate"
]
}{
"error": "invalid token",
"code": "unauthorized",
"request_id": "req_01JAB3K9X2"
}{
"error": "invoice not found",
"code": "not_found",
"request_id": "req_01JAB3K9X2"
}Preview. A contract we are building with design partners. It is not callable yet, and fields can still change. See Availability.
Authorizations
Your partner secret key, mk_live_… for real companies or mk_test_…
for test companies. Keep it on your servers. See
Authentication.
Path Parameters
The company's ID. Every company-scoped call works in exactly this company.
Query Parameters
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.
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"
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"
Show child attributes
Show child attributes
What makes the estimate less certain.