Annual Reports

An annual report order files the company's periodic report with a state. Include annualReport in POST /orders with an existing companyId:

curl -X POST https://api.fileforms.com/v1/orders \
  -H "x-api-key: sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "user_a1b2c3d4e5f6g7h8",
    "companyId": "comp_x1y2z3w4v5u6t7s8",
    "filingState": "FL",
    "annualReport": {
      "filingYear": "2026"
    },
    "registeredAgent": { "isChangeOfAgent": false }
  }'

Field requirements

• filingYear — required, a four-digit string ("2026", not 2026).
• Registered agent — the filing state must have an agent on record. If the company already has active FileForms RA service there, you're done. Otherwise either order RA service in the same request (as above) or supply the existing agent's details in annualReport.registeredAgent (its address state must equal filingState).
• The company's entityType and formationState drive the state fee, so make sure they're set on the company record.

What it costs, and when reports vary

The debit is the annual report wholesale price plus the state's fee. State fees for annual reports vary widely — some states charge nothing, some calculate from entity attributes ("Varies" in the state fees table, support coming soon), and filing cadence differs by state and entity type. States whose reports are biennial are handled through the same annualReport order — the cadence is a property of the state, not a different product.

Subscriptions

Annual report is a subscription product: ordering one establishes an annual subscription for that company + state, and order items report a subscriptionStatus (active | canceled | past_due). Renewal reports are generated under the subscription so the company stays compliant year over year.

After ordering

• filing.status_changed → filed with filingDate when the state accepts it (reports pass through pending while queued with the state)
• document.uploaded → the filed report / state confirmation
• A common exception: code 482, a prior-year report problem that must be cured first