curl --request POST \
--url https://api.test.doola.com/v1/partner/companies/{companyId}/tax/confirm \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"taxYear": 2026
}
'const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({taxYear: 2026})
};
fetch('https://api.test.doola.com/v1/partner/companies/{companyId}/tax/confirm', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const url = 'https://api.test.doola.com/v1/partner/companies/{companyId}/tax/confirm';
const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({taxYear: 2026})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));import requests
url = "https://api.test.doola.com/v1/partner/companies/{companyId}/tax/confirm"
payload = { "taxYear": 2026 }
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.test.doola.com/v1/partner/companies/{companyId}/tax/confirm"
payload := strings.NewReader("{\n \"taxYear\": 2026\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.test.doola.com/v1/partner/companies/{companyId}/tax/confirm")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"taxYear\": 2026\n}")
.asString();<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.test.doola.com/v1/partner/companies/{companyId}/tax/confirm",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'taxYear' => 2026
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"companyId": "<string>",
"taxYear": 2026,
"entitledThrough": "2027-10-15"
}Confirm a company's tax filing for a tax year
Tells doola you sold the company its federal tax return for a tax year, the same way you confirm a formation’s payment. Until you do, the company cannot start that return in the embedded app. The confirmation lasts until the tax year’s filing season closes; the next tax year needs a confirmation of its own. One tax year is confirmable at a time, the earliest whose filing season is open: in calendar year N, tax year N - 1 until its season closes on October 15 of N (moved past a weekend or holiday), then tax year N. From that close through December 31 this is the year after the one the tax filing years list returns. Nothing is charged here: doola settles with you under your partner agreement, outside this API. Safe to repeat: confirming a year already confirmed changes nothing and answers the same.
curl --request POST \
--url https://api.test.doola.com/v1/partner/companies/{companyId}/tax/confirm \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"taxYear": 2026
}
'const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({taxYear: 2026})
};
fetch('https://api.test.doola.com/v1/partner/companies/{companyId}/tax/confirm', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const url = 'https://api.test.doola.com/v1/partner/companies/{companyId}/tax/confirm';
const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({taxYear: 2026})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));import requests
url = "https://api.test.doola.com/v1/partner/companies/{companyId}/tax/confirm"
payload = { "taxYear": 2026 }
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.test.doola.com/v1/partner/companies/{companyId}/tax/confirm"
payload := strings.NewReader("{\n \"taxYear\": 2026\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.test.doola.com/v1/partner/companies/{companyId}/tax/confirm")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"taxYear\": 2026\n}")
.asString();<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.test.doola.com/v1/partner/companies/{companyId}/tax/confirm",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'taxYear' => 2026
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"companyId": "<string>",
"taxYear": 2026,
"entitledThrough": "2027-10-15"
}Authorizations
Body
The tax year whose federal tax return you sold the company.
The tax year the return covers. A return for tax year N is filed in N + 1. One tax year is accepted at a time: the earliest whose filing season is open. That is the previous year until its season closes on October 15 of the current year (moved past a weekend or holiday), then the current year. For example, from October 16, 2026 through October 15, 2027 you confirm tax year 2026.
2000 <= x <= 21002026
Response
The tax year is confirmed, or already was.
A confirmed tax year and how long the company can file it through doola.
The last day, in America/New_York, the company holds tax filing under this confirmation: the tax year's latest extended deadline, October 15 of the following year, moved to the next business day when it falls on a weekend or holiday. A company whose own return is due earlier still has to file by its own deadline.
"2027-10-15"