curl --request GET \
--url https://api.test.doola.com/v1/partner/companies/{companyId}/tax-filings/years/{taxYear} \
--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/{taxYear}', 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/{taxYear}';
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/{taxYear}"
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/{taxYear}"
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/{taxYear}")
.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/{taxYear}",
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"
}Get a company's tax filing status for one tax year
One tax year’s status, due date, filing window, whether the customer can file it and the last day your confirm for the year covers. Any tax year from 2000 to 2100 answers; a year with nothing on record, even one before the company existed, reads a derived NOT_STARTED. Read the year the list returns, or the year you confirmed.
curl --request GET \
--url https://api.test.doola.com/v1/partner/companies/{companyId}/tax-filings/years/{taxYear} \
--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/{taxYear}', 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/{taxYear}';
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/{taxYear}"
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/{taxYear}"
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/{taxYear}")
.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/{taxYear}",
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
Path Parameters
Response
The company's tax filing status for the year.
Where a company's federal tax return for one tax year stands.
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"