Skip to main content
GET
Get a company's tax filing status for one tax year

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).

taxYear
integer<int32>
required

The tax year the return covers, e.g. 2025.

Required range: 2000 <= x <= 2100

Response

The company's tax filing status for the year.

Where a company's federal tax return for one tax year stands.

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"