> ## Documentation Index
> Fetch the complete documentation index at: https://docs.doola.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Authenticate with the raw API key in the Authorization header. Never add a Bearer prefix.
> Use the sandbox base URL https://api.test.doola.com and a dk_test_ key in examples unless the user asks for production.
> Send an Idempotency-Key header on POST /v1/partner/customers, POST /v1/partner/companies, POST /v1/partner/companies/import, POST /v1/partner/companies/{companyId}/services and POST /v1/partner/companies/{companyId}/documents. No other endpoint takes one.
> Every response is wrapped as {payload, error}. Read fields from payload and branch on error.code, never on the message.
> Drive formation progress from webhooks plus a reconciliation sweep, never a polling loop.
> Embedded SDK (@doola/js): the dk_ key stays on the server and mints customer sessions; the browser gets only a pk_ key and the session. onFormed carries only companyId and can fire more than once. Before charging, read the company with the dk_ key, require formationSubmissionStatus AWAITING_PAYMENT, check the owner's email, and price on the server. Then POST payment-confirmed, which answers 200 with an empty body, and replace the SDK element with a new doola.create() (never append a second one).
> The doola Formation MCP server at https://mcp.doola.com is for founders forming their own company with their own doola account. Platform partners integrate the Partner API or the Embedded SDK. The /mcp endpoint on this docs site only searches these docs.
> Affiliates refer founders to doola with a PartnerStack referral link and coupon code, or with two doola-branded iframe widgets: the Demo Booking Widget (app.doola.com/embed/book-demo?link=<referral link>) and the Company Formation Widget (app.doola.com/embed/partner/<partner ID>). The widgets need no API key and are not the Embedded SDK. Copy the snippets exactly as documented, never add a sandbox attribute to the formation widget iframe.
> For a full capability summary with the rules above, read https://docs.doola.com/skill.md.

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



## OpenAPI

````yaml /api-reference/openapi.json get /v1/partner/companies/{companyId}/tax-filings/years/{taxYear}
openapi: 3.1.0
info:
  title: doola Partner API
  description: >-
    REST API for doola partners to create and manage customers and companies,
    retrieve formation documents, and look up reference data.


    Authenticate every request with a partner API key in the `Authorization`
    header. Generate keys and manage your webhook endpoint in the doola Partner
    Portal.
  contact:
    name: doola
    url: https://www.doola.com
  version: v1
servers:
  - url: https://api.test.doola.com
    description: Sandbox — use test keys (dk_test_…)
  - url: https://api.doola.com
    description: Production — use live keys (dk_live_…)
security:
  - PartnerApiKey: []
tags:
  - name: Required Actions
    description: >-
      Actions doola needs you to take on a company, such as supplying new name
      options after a state rejection.
  - name: Compliance
    description: Track a company's compliance obligations and their due dates.
  - name: Documents
    description: List, download and upload a company's formation documents.
  - name: Companies
    description: Create companies for your customers, then track formation status.
  - name: Reference data
    description: >-
      Static lookups for building company-creation requests: NAICS codes,
      states, countries, and state filing fees.
  - name: Playground (sandbox only)
    description: >-
      Sandbox-only helpers to drive a test company through the Formation and
      EinCreation milestones end to end.
  - name: Customers
    description: Create and look up customers under your partner tenant.
  - name: Annual Report Filing
    description: >-
      File a company's annual report with its state: what to collect, what it
      costs, submission, confirmation and status.
  - name: Customer sessions
    description: Mint the token the doola SDK uses in your customer's browser.
  - name: Tax Filing
    description: >-
      Track and confirm a company's federal tax filing for each tax year: where
      the return stands, when it is due and whether the filing window is open.
  - name: Signatures
    description: Request embedded signing sessions for pending company documents.
  - name: Companies
    description: >-
      Create or import companies for your customers, then track formation
      status.
  - name: SDK
    description: Keys for the doola Embedded SDK.
paths:
  /v1/partner/companies/{companyId}/tax-filings/years/{taxYear}:
    get:
      tags:
        - Tax Filing
      summary: Get a company's tax filing status for one tax year
      description: >-
        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.
      operationId: getTaxFilingYear
      parameters:
        - name: companyId
          in: path
          description: doola company ID (KSUID).
          required: true
          schema:
            type: string
        - name: taxYear
          in: path
          description: The tax year the return covers, e.g. 2025.
          required: true
          schema:
            type: integer
            format: int32
            maximum: 2100
            minimum: 2000
      responses:
        '200':
          description: The company's tax filing status for the year.
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/PartnerTaxFilingYearDto'
        '400':
          description: 'E_VALIDATION_FAILED: taxYear is not between 2000 and 2100.'
        '403':
          description: 'E_ACCESS_DENIED: the credential may not read tax filing status.'
        '404':
          description: >-
            E_COMPANY_NOT_FOUND: the company does not exist, or is not owned by
            the calling partner.
components:
  schemas:
    PartnerTaxFilingYearDto:
      type: object
      description: Where a company's federal tax return for one tax year stands.
      properties:
        doolaCompanyId:
          type: string
          description: doola company ID (KSUID).
          example: 2Ns8vJqZ1lQwErTyUiOpAsDfGhJ
        taxYear:
          type: integer
          format: int32
          description: The tax year the return covers.
          example: 2025
        status:
          type: string
          description: Where the return stands.
          enum:
            - 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:
          type: string
          description: The status as doola shows it to the customer.
          example: Complete Your Tax Information
        taxClassification:
          type:
            - string
            - 'null'
          description: How the IRS taxes the company. Null until doola can classify it.
          enum:
            - FOREIGN_OWNED_SMLLC
            - US_OWNED_SMLLC
            - MULTI_MEMBER_LLC
            - S_CORPORATION
            - C_CORPORATION
            - null
          example: FOREIGN_OWNED_SMLLC
        dueDate:
          type:
            - string
            - 'null'
          format: date
          description: >-
            Filing deadline, the extended one when extensionFiled. Null when
            taxClassification is null.
          example: '2026-04-15'
        extensionFiled:
          type: boolean
          description: A Form 7004 extension is on file.
        autoExtension:
          type: boolean
          description: doola will file a Form 7004 extension for the company.
        windowOpensOn:
          type: string
          format: date
          description: 'First day of the filing window: January 6 of taxYear + 1.'
          example: '2026-01-06'
        windowClosesOn:
          type:
            - string
            - 'null'
          format: date
          description: >-
            Last day of the filing window, equal to dueDate. Null when
            taxClassification is null.
          example: '2026-04-15'
        nextWindowOpensOn:
          type: string
          format: date
          description: The next January 6 on or after today, America/New_York.
          example: '2027-01-06'
        windowOpen:
          type: boolean
          description: Today, America/New_York, is inside the filing window.
        submittedAt:
          type:
            - string
            - 'null'
          format: date-time
          description: >-
            When the customer submitted their tax information to doola. Null
            until they do.
        filedAt:
          type:
            - string
            - 'null'
          format: date-time
          description: When the return was filed. Null until it is.
        availability:
          type: string
          description: >-
            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.
          enum:
            - AVAILABLE
            - PENDING_EIN
            - NOT_ELIGIBLE_THIS_YEAR
            - NOT_AVAILABLE
          example: AVAILABLE
        entitledThrough:
          type:
            - string
            - 'null'
          format: date
          description: >-
            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'
      required:
        - autoExtension
        - availability
        - doolaCompanyId
        - dueDate
        - entitledThrough
        - extensionFiled
        - filedAt
        - label
        - nextWindowOpensOn
        - status
        - submittedAt
        - taxClassification
        - taxYear
        - windowClosesOn
        - windowOpen
        - windowOpensOn
  securitySchemes:
    PartnerApiKey:
      type: apiKey
      description: >-
        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.
      name: Authorization
      in: header

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.