curl --request GET \
--url https://api.test.doola.com/v1/partner/companies/{companyId}/tax-filings/years \
--header 'Authorization: <api-key>'const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.test.doola.com/v1/partner/companies/{companyId}/tax-filings/years', 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-filings/years';
const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
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-filings/years"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.test.doola.com/v1/partner/companies/{companyId}/tax-filings/years"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.test.doola.com/v1/partner/companies/{companyId}/tax-filings/years")
.header("Authorization", "<api-key>")
.asString();<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.test.doola.com/v1/partner/companies/{companyId}/tax-filings/years",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}[
{
"doolaCompanyId": "2Ns8vJqZ1lQwErTyUiOpAsDfGhJ",
"taxYear": 2025,
"status": "INTAKE_IN_PROGRESS",
"label": "Complete Your Tax Information",
"taxClassification": "FOREIGN_OWNED_SMLLC",
"dueDate": "2026-04-15",
"extensionFiled": true,
"autoExtension": true,
"windowOpensOn": "2026-01-06",
"windowClosesOn": "2026-04-15",
"nextWindowOpensOn": "2027-01-06",
"windowOpen": true,
"submittedAt": "2023-11-07T05:31:56Z",
"filedAt": "2023-11-07T05:31:56Z",
"availability": "AVAILABLE",
"entitledThrough": "2027-10-15"
}
]List a company's tax filing years
The tax years the company can file for, newest first, each with its status, due date, filing window, whether the customer can file it and the last day your confirm for the year covers. Today this is one entry, the current filing year: in calendar year N it is tax year N - 1, whose return is filed in N. That is not always the year to confirm. The confirm takes only the earliest tax year whose filing season is open: tax year N - 1 until its season closes on October 15 of N (moved past a weekend or holiday), then tax year N. So from that close through December 31, confirm the year after the one listed here.
curl --request GET \
--url https://api.test.doola.com/v1/partner/companies/{companyId}/tax-filings/years \
--header 'Authorization: <api-key>'const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.test.doola.com/v1/partner/companies/{companyId}/tax-filings/years', 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-filings/years';
const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
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-filings/years"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.test.doola.com/v1/partner/companies/{companyId}/tax-filings/years"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.test.doola.com/v1/partner/companies/{companyId}/tax-filings/years")
.header("Authorization", "<api-key>")
.asString();<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.test.doola.com/v1/partner/companies/{companyId}/tax-filings/years",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}[
{
"doolaCompanyId": "2Ns8vJqZ1lQwErTyUiOpAsDfGhJ",
"taxYear": 2025,
"status": "INTAKE_IN_PROGRESS",
"label": "Complete Your Tax Information",
"taxClassification": "FOREIGN_OWNED_SMLLC",
"dueDate": "2026-04-15",
"extensionFiled": true,
"autoExtension": true,
"windowOpensOn": "2026-01-06",
"windowClosesOn": "2026-04-15",
"nextWindowOpensOn": "2027-01-06",
"windowOpen": true,
"submittedAt": "2023-11-07T05:31:56Z",
"filedAt": "2023-11-07T05:31:56Z",
"availability": "AVAILABLE",
"entitledThrough": "2027-10-15"
}
]Authorizations
Response
The company's tax filing years, newest first.
Where the return stands.
NOT_STARTED, INTAKE_IN_PROGRESS, ENGAGEMENT_SIGNATURE_REQUIRED, READY_FOR_HANDOFF, INTAKE_REVIEW, DOCUMENTS_RECEIVED, PREPARATION_IN_PROGRESS, REVIEW_IN_PROGRESS, RETURN_SIGNATURE_REQUIRED, ACTION_REQUIRED, CLIENT_UNRESPONSIVE, RETURN_FILED, SCHEDULE_C_COMPLETED, FILING_CANCELED "INTAKE_IN_PROGRESS"
Whether the customer can file this tax year through doola. A year that already has a return is AVAILABLE, since it resumes. Otherwise it comes from your tax confirm for the year and the company's eligibility. The filing window is not part of it: read windowOpen and windowOpensOn for when a new return can start. AVAILABLE: the customer can resume the return, and start it while windowOpen. PENDING_EIN: the company needs its EIN first. NOT_ELIGIBLE_THIS_YEAR: the company was formed too late to file this year. NOT_AVAILABLE: anything else, such as no confirm for this tax year.
AVAILABLE, PENDING_EIN, NOT_ELIGIBLE_THIS_YEAR, NOT_AVAILABLE "AVAILABLE"