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

# List a company's annual reports

> The company's annual reports, one per fiscal year, newest first, each with where it stands and the price fixed on it. Read-only. A report in a state this API does not publish is left out, so the list can be shorter than what doola holds. An empty list means nothing to show; a company that does not exist or is not yours is 404.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/partner/companies/{companyId}/compliance/annual-reports
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 webhooks and event subscriptions 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: Playground (sandbox only)
    description: >-
      Sandbox-only helpers to drive a test company through the Formation and
      EinCreation milestones end to end.
  - name: Required Actions
    description: >-
      Actions doola needs you to take on a company, such as supplying new name
      options after a state rejection.
  - name: Customers
    description: Create and look up customers under your partner tenant.
  - name: Documents
    description: List and download a company's formation documents.
  - name: Compliance
    description: Track a company's compliance obligations and their due dates.
  - 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: Signatures
    description: Request embedded signing sessions for pending company 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.
paths:
  /v1/partner/companies/{companyId}/compliance/annual-reports:
    get:
      tags:
        - Annual Report Filing
      summary: List a company's annual reports
      description: >-
        The company's annual reports, one per fiscal year, newest first, each
        with where it stands and the price fixed on it. Read-only. A report in a
        state this API does not publish is left out, so the list can be shorter
        than what doola holds. An empty list means nothing to show; a company
        that does not exist or is not yours is 404.
      operationId: listAnnualReports
      parameters:
        - name: companyId
          in: path
          description: doola company ID (KSUID).
          required: true
          schema:
            type: string
      responses:
        '200':
          description: The company's annual reports, newest fiscal year first.
          content:
            '*/*':
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/PartnerAnnualReportSummaryDto'
        '404':
          description: >-
            E_COMPANY_NOT_FOUND: the company does not exist, or is not owned by
            the calling partner.
components:
  schemas:
    PartnerAnnualReportSummaryDto:
      type: object
      description: One of a company's annual reports.
      properties:
        annualReportId:
          type: string
          description: >-
            Annual report ID (KSUID), as the submission returned it and as
            confirm addresses it.
          example: 2Ns8vJqZ1lQwErTyUiOpAsDfGhJ
        doolaCompanyId:
          type: string
          description: doola company ID (KSUID).
          example: 2Ns8vJqZ1lQwErTyUiOpAsDfGhJ
        fiscalYear:
          type: integer
          format: int32
          description: Fiscal year the report covers.
          example: 2026
        state:
          type: string
          description: US state the report is filed in.
          example: WY
        entityType:
          type: string
          description: Entity type the report was filed for.
          enum:
            - LLC
            - CCorp
          example: LLC
        status:
          type: string
          description: >-
            Where the report stands. FILLED is submitted and waiting for you to
            confirm it; IN_PROGRESS is confirmed and doola's to work;
            AWAITING_INFORMATION means doola needs something back before it can
            file; FILING_COMPLETED is filed with the state and final.
          enum:
            - FILLED
            - IN_PROGRESS
            - AWAITING_INFORMATION
            - FILING_COMPLETED
          example: FILLED
        priceInCents:
          type:
            - integer
            - 'null'
          format: int64
          description: >-
            The state fee fixed on the report in whole US cents, which doola
            settles with you outside this API. Null while doola has not priced
            it, as on a report the customer started in doola's own app.
          example: 6225
        submittedAt:
          type:
            - string
            - 'null'
          description: >-
            Date the report was handed to doola's filing pipeline (yyyy-MM-dd).
            Often null even for a filed report: only some routes stamp it. Read
            status for where the report stands, never this date.
          example: '2026-03-01'
        createdAt:
          type:
            - string
            - 'null'
          format: date-time
          description: >-
            When the report was first recorded. Null if the row carries no
            timestamp.
          example: '2026-02-01T09:00:00Z'
        updatedAt:
          type:
            - string
            - 'null'
          format: date-time
          description: When the report last changed. Null if the row carries no timestamp.
          example: '2026-02-02T09:00:00Z'
  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

````