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

# Confirm a company's tax filing for a tax year

> Tells doola you sold the company its federal tax return for a tax year, the same way you confirm a formation's payment. Until you do, the company cannot start that return in the embedded app. The confirmation lasts until the tax year's filing season closes; the next tax year needs a confirmation of its own. One tax year is confirmable at a time, the earliest whose filing season is open: in calendar year N, tax year N - 1 until its season closes on October 15 of N (moved past a weekend or holiday), then tax year N. From that close through December 31 this is the year after the one the tax filing years list returns. Nothing is charged here: doola settles with you under your partner agreement, outside this API. Safe to repeat: confirming a year already confirmed changes nothing and answers the same.



## OpenAPI

````yaml /api-reference/openapi.json post /v1/partner/companies/{companyId}/tax/confirm
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/confirm:
    post:
      tags:
        - Tax Filing
      summary: Confirm a company's tax filing for a tax year
      description: >-
        Tells doola you sold the company its federal tax return for a tax year,
        the same way you confirm a formation's payment. Until you do, the
        company cannot start that return in the embedded app. The confirmation
        lasts until the tax year's filing season closes; the next tax year needs
        a confirmation of its own. One tax year is confirmable at a time, the
        earliest whose filing season is open: in calendar year N, tax year N - 1
        until its season closes on October 15 of N (moved past a weekend or
        holiday), then tax year N. From that close through December 31 this is
        the year after the one the tax filing years list returns. Nothing is
        charged here: doola settles with you under your partner agreement,
        outside this API. Safe to repeat: confirming a year already confirmed
        changes nothing and answers the same.
      operationId: confirmTaxYear
      parameters:
        - name: companyId
          in: path
          description: doola company ID (KSUID).
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PartnerTaxConfirmationRequest'
        required: true
      responses:
        '200':
          description: The tax year is confirmed, or already was.
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/PartnerTaxConfirmationResponse'
        '400':
          description: >-
            E_VALIDATION_FAILED: taxYear is missing or outside 2000 to 2100, or
            is not the one tax year confirmable today, the earliest whose filing
            season is open. Reported under error.fields.taxYear, which names
            that year.
        '403':
          description: >-
            E_ACCESS_DENIED: the credential may not confirm tax filing.
            E_SCOPE_NOT_ENTITLED: your account is not enabled for tax filing.
        '404':
          description: >-
            E_COMPANY_NOT_FOUND: the company does not exist, or is not owned by
            the calling partner.
components:
  schemas:
    PartnerTaxConfirmationRequest:
      type: object
      description: The tax year whose federal tax return you sold the company.
      properties:
        taxYear:
          type: integer
          format: int32
          description: >-
            The tax year the return covers. A return for tax year N is filed in
            N + 1. One tax year is accepted at a time: the earliest whose filing
            season is open. That is the previous year until its season closes on
            October 15 of the current year (moved past a weekend or holiday),
            then the current year. For example, from October 16, 2026 through
            October 15, 2027 you confirm tax year 2026.
          example: 2026
          maximum: 2100
          minimum: 2000
      required:
        - taxYear
    PartnerTaxConfirmationResponse:
      type: object
      description: A confirmed tax year and how long the company can file it through doola.
      properties:
        companyId:
          type: string
          description: doola company ID (KSUID).
        taxYear:
          type: integer
          format: int32
          description: The tax year confirmed.
          example: 2026
        entitledThrough:
          type: string
          format: date
          description: >-
            The last day, in America/New_York, the company holds tax filing
            under this confirmation: the tax year's latest extended deadline,
            October 15 of the following year, moved to the next business day
            when it falls on a weekend or holiday. A company whose own return is
            due earlier still has to file by its own deadline.
          example: '2027-10-15'
      required:
        - companyId
        - entitledThrough
        - taxYear
  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.