Skip to main content
GET
List a company's tax filing years

Authorizations

Authorization
string
header
required

Partner API key. Send the raw key as the Authorization header value — e.g. dk_test_… in sandbox or dk_live_… in production. Generate and rotate keys in the doola Partner Portal.

Path Parameters

companyId
string
required

doola company ID (KSUID).

Response

The company's tax filing years, newest first.

doolaCompanyId
string
required

doola company ID (KSUID).

Example:

"2Ns8vJqZ1lQwErTyUiOpAsDfGhJ"

taxYear
integer<int32>
required

The tax year the return covers.

Example:

2025

status
enum<string>
required

Where the return stands.

Available options:
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
Example:

"INTAKE_IN_PROGRESS"

label
string
required

The status as doola shows it to the customer.

Example:

"Complete Your Tax Information"

taxClassification
enum<string> | null
required

How the IRS taxes the company. Null until doola can classify it.

Available options:
FOREIGN_OWNED_SMLLC,
US_OWNED_SMLLC,
MULTI_MEMBER_LLC,
S_CORPORATION,
C_CORPORATION,
null
Example:

"FOREIGN_OWNED_SMLLC"

dueDate
string<date> | null
required

Filing deadline, the extended one when extensionFiled. Null when taxClassification is null.

Example:

"2026-04-15"

extensionFiled
boolean
required

A Form 7004 extension is on file.

autoExtension
boolean
required

doola will file a Form 7004 extension for the company.

windowOpensOn
string<date>
required

First day of the filing window: January 6 of taxYear + 1.

Example:

"2026-01-06"

windowClosesOn
string<date> | null
required

Last day of the filing window, equal to dueDate. Null when taxClassification is null.

Example:

"2026-04-15"

nextWindowOpensOn
string<date>
required

The next January 6 on or after today, America/New_York.

Example:

"2027-01-06"

windowOpen
boolean
required

Today, America/New_York, is inside the filing window.

submittedAt
string<date-time> | null
required

When the customer submitted their tax information to doola. Null until they do.

filedAt
string<date-time> | null
required

When the return was filed. Null until it is.

availability
enum<string>
required

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 options:
AVAILABLE,
PENDING_EIN,
NOT_ELIGIBLE_THIS_YEAR,
NOT_AVAILABLE
Example:

"AVAILABLE"

entitledThrough
string<date> | null
required

The last day, in America/New_York, the company holds tax filing under your confirm for this tax year: the same entitledThrough the confirm answered. Null when the year has no live confirm.

Example:

"2027-10-15"