DOdoola
Annual Report Filing

Get the annual report requirements for a company

Changed on

Returns the fields the partner must collect before submitting the company's annual report, derived from its state and entity type, together with the due date from the compliance calendar. Read-only. Most states ask no questions at all, so for most companies the response carries only the company details. A state that requires no annual report answers 200 with isFilingRequired false and an empty field list. Returns 404 when the company does not exist or is not owned by the calling partner.

get/v1/partner/companies/{companyId}/compliance/annual-reports/requirements

Request

  • Base URL
    https://api.test.doola.com
  • URL
    https://api.test.doola.com/v1/partner/companies/{companyId}/compliance/annual-reports/requirements
  • Auth
    API key in header Authorization

Path parameters

companyIdstring required

doola company ID (KSUID).

Query parameters

fiscalYearinteger

Fiscal year the report covers. Defaults to the current year.

Response

The fields to collect, with the due date. Only a handful of states add question fields on top of the company details. Read isFilingRequired first: when false there is no report to file and the field list is empty.

doolaCompanyIdstring

doola company ID (KSUID).

statestring

US state the report is filed in.

entityType'LLC' | 'CCorp'

Entity type the field list applies to.

fiscalYearinteger

Fiscal year the requirements apply to.

dueDatestring nullable

Due date from the compliance calendar (yyyy-MM-dd), or null when there is no concrete date yet.

isFilingRequiredboolean

Whether the state requires an annual report at all. False comes with an empty fields list because there is nothing to file - not because the state asks for nothing.

Example response

{
  "doolaCompanyId": "2Ns8vJqZ1lQwErTyUiOpAsDfGhJ",
  "state": "WY",
  "entityType": "LLC",
  "fiscalYear": 2026,
  "dueDate": "2026-11-30",
  "fields": [
    {
      "fieldId": "Q16",
      "label": "Do you hold assets?",
      "type": "RADIO",
      "group": "QUESTION",
      "required": true,
      "affectsFee": true,
      "options": [
        "yes",
        "no"
      ],
      "dependsOn": {
        "fieldId": "Q16",
        "answer": "yes"
      }
    }
  ],
  "isFilingRequired": true
}

Changes