Registered Agent

Registered agent service appoints FileForms as the company's agent for service of process in a state, receives official mail there, and forwards it to you as document.uploaded events.

Include registeredAgent in POST /orders:

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": "TX",
    "registeredAgent": { "isChangeOfAgent": true }
  }'

isChangeOfAgent

The one required field:

• false — a new appointment, typically ordered alongside a formation or foreign qualification where FileForms becomes the agent from day one. (When ordered with a formation it's always treated as a new appointment.)
• true — a change of agent filing with the state, replacing the company's current agent with FileForms. Status events for these carry "filingType": "change_of_agent".

Service vs. supplying your own agent

Ordering registeredAgent buys FileForms' RA service — FileForms' own agent address is used automatically; you never supply one.

If the company already has an agent you want to keep, don't order registeredAgent. Instead, pass the agent's details in the product that needs them (formation.registeredAgent, annualReport.registeredAgent, or foreignQualification.registeredAgent). A supplied agent can be a person or a company, and its address state must equal the filingState.

Note the shape: unlike officers and companies (which nest an address object), a supplied agent uses flat address fields:

"registeredAgent": {
  "type": "COMPANY",
  "companyName": "Lone Star Agents Inc",
  "addressStreet": "456 Congress Ave",
  "addressCity": "Austin",
  "addressState": "TX",
  "addressZip": "78701"
}

With "type": "PERSON", send firstName/lastName instead of companyName.

If the company already has active FileForms RA service in the filing state, ordering registeredAgent again is a no-op — the request succeeds but no duplicate service or charge is created.

Billing

Registered agent is an annual subscription (order items report subscriptionStatus). For balance-billed API orders, your balance is debited the RA wholesale price when the order is placed; there is no state fee for the service itself.

For orders paid through in-app checkout, note that the tier 2/3 formation packages add RA as its own subscription line item at checkout — see Custom pricing.

After ordering

• For change-of-agent filings: filing.status_changed events (with filingType: "change_of_agent") as the state processes the change
• Ongoing: state and legal mail received by the agent arrives as document.uploaded events (documentType: "registered_agent"). If your organization's email notifications are on, users are emailed about the mail too.