Skip to main content
POST
Quote the annual report fee for a company

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

Body

application/json

Figures to price the annual report from. Every member is optional.

fiscalYear
integer<int32> | null

Fiscal year the quote is for. Echoed back unchanged; the state fee does not vary by year today.

Required range: 2000 <= x <= 2100
Example:

2026

answers
object[] | null

Answers to the fields a prior call named in inputFieldIds, each field at most once. A field the state does not price from is ignored. Omit to be told which fields are needed; send an empty list to declare them all zero.

Response

Either the fee, or the fields still to collect. needsInput says which; filingRequired says whether there is a report to file at all.

What the company's state charges for its annual report.

doolaCompanyId
string

doola company ID (KSUID).

Example:

"2Ns8vJqZ1lQwErTyUiOpAsDfGhJ"

state
string

US state the report is filed in.

Example:

"WY"

entityType
enum<string>

Entity type the quote applies to.

Available options:
LLC,
CCorp
Example:

"LLC"

fiscalYear
integer<int32>

Fiscal year the quote was requested for.

Example:

2026

filingRequired
boolean

Whether the state requires an annual report at all. False comes with an amount of 0 and pricingType NO_REPORT: nothing to file and nothing to pay. Do not read a 0 amount on its own - a FREE state also charges nothing, but the report still has to be filed.

Example:

true

pricingType
enum<string>

How the state arrives at the fee. FIXED is a set amount, DYNAMIC is computed, FREE is filed at no charge, NO_REPORT means no report is filed.

Available options:
FIXED,
FREE,
DYNAMIC,
NO_REPORT
Example:

"FIXED"

needsInput
boolean

True when the state prices from figures the customer must declare and none were supplied. Collect the fields in inputFieldIds and call again.

Example:

false

inputFieldIds
string[] | null

Fields to collect before the fee can be quoted, null unless needsInput.

Example:
amount
number | null

The state fee, null when needsInput. Zero when filingRequired is false, and zero for a FREE state that is filed at no charge.

Example:

202.35

currency
enum<string>

Currency of the amount. Always USD; state fees are never billed in anything else.

Available options:
USD
Example:

"USD"

formula
string | null

How the amount was arrived at, for states that compute it.

Example:

"Assets: $1,000,000.00 x 0.0002"

message
string | null

Plain-language note about the fee.

Example:

"Fixed state fee"