filing.blocked

Typed resource ID. Prefix encodes the resource type (e.g. ent_ Entity, flg_ Filing, doc_ Document). Stable across API versions.

Discriminator string equal to the resource type name in snake_case (e.g. entity, filing). Useful when you receive a polymorphic event payload and need to dispatch on type.

Home-jurisdiction lifecycle state. Foreign qualifications track independently via qualifications[]. Terminal states split by exit shape: dissolved for self-initiated wind-down; acquired, merged, or sold when a CorporateTransaction closes. in_transaction is a live M&A hold set when a CorporateTransaction advances past definitive.

ISO 3166-2 subdivision code. For US entities, this is the formation state (US-DE, US-CA). For entities in other countries, top-level jurisdiction code.

DBAs and prior names.

Unix timestamp of entity birth. Null until registered.

Set when the entity transitions to acquired on close of an acquisition CorporateTransaction.

Set when the entity transitions to merged on close of a merger CorporateTransaction.

Set when the entity transitions to sold on close of an asset-sale CorporateTransaction.

The Workspace this entity was formed inside, if any. Set when the entity is created from inside a workspace's chat surface (the canonical onboarding flow); null for entities created directly via POST /v1/entities without a workspace context (the SDK-first / batch-create paths).

The CorporateTransaction that produced this entity's terminal or in_transaction state. Null for entities that exited via self-initiated dissolution or are still operating.

Structured address.

Structured address.

The natural-person stakeholder named as incorporator on the Certificate of Incorporation. Required at POST /entities. Must reference a Stakeholder with kind = "natural_person". Matter never signs as incorporator — the customer's named founder does, either directly via a signing envelope (Rail 1) or through their electronic agent under UETA §14 standing consent (Rail 2). See legal basis and the incorporator protocol.

Computed view key (cap_table is not a stored resource).

Foreign qualifications. Each carries its own state and compliance track.

Rolled-up compliance snapshot across home + qualifications.

The intent that originated this entity, if any.

Curated pointers to the entity's foundational documents. Eliminates the N+1 query against GET /documents?type=… for the documents callers reach for constantly. Each pointer is null until the document is generated; populated in step with the formation packet cascade and refreshed on every charter amendment.

Sub-state of the Day-0 formation packet cascade emitted by POST /entities/{id}/formation_packet. Surfaces the implicit progression today inferred only from filings and document types. Webhook entity.formation_packet_status.changed fires on every transition.

Outcome of the state/federal filing-office interaction for this entity's formation or initial report — distinct from the home-jurisdiction lifecycle status. prepared means a browser-agent run filled and validated every field, reconciled the fee, captured tamper-evident proof, and stopped at the pre-submit screen without submitting; blocked means the run raised a structured Blocker (see browser_agent_run.blocker). Null until a filing interaction starts.

The in-flight or most-recent browser-agent run preparing a filing for this entity, if any. Null when no run is attached. The run is keyed to the entity (formation is an entity lifecycle, not a Filing row).

Expanded summary of active_browser_agent_run_id. Present only when requested via expand[]=browser_agent_run; otherwise null. Read-only.

Caller-owned map<string, string> for arbitrary application context. Up to 50 keys, 40 chars per key, 500 chars per value. The matter_ key prefix is platform-reserved. Never store secrets here. See metadata.

Unix timestamp (seconds since epoch) when this resource was first created. Immutable.

Unix timestamp (seconds since epoch) when this resource was last mutated. Bumps on every state transition. Use as the If-Match ETag input for optimistic concurrency.

true when this resource exists in the live (production) dataset; false for test mode. Determined by the credential that created it; immutable thereafter. See test mode.

Typed resource ID. Prefix encodes the resource type (bar_ BrowserAgentRun). Stable across API versions.

Discriminator string equal to the resource type name in snake_case.

The entity whose filing this run prepares. The run attaches to the entity, not to a Filing row.

Internal discriminator for which filing the run prepares (e.g. formation, initial_report). A string, not a Filing.kind enum member — formation is an entity lifecycle, not a Filing resource.

Always false. The run prepares the filing and stops before submit; no code path in the run can set this true. Surfaced explicitly so an agent never assumes a prepared filing was filed.

Coarse lifecycle state mirrored from the engine. prepared and blocked are terminal; pending/running are transient; deferred is a durable pause for a closed portal window that re-enters the queue on reopen.

recipe when the run filled deterministically from the field map with no model in the loop; assisted when a bounded, structurally-fenced self-heal proposal occurred. The happy path is always recipe.

Residency region the run executed in. Pins the proof bucket and any self-heal proposal endpoint.

The independently computed expected filing fee, in USD. Null until the fee step runs.

The fee the portal rendered, in USD. Must equal computed_fee_usd or the run blocks with a fee-mismatch reason. Null until the fee step runs.

Reference to the write-once, object-locked proof blob captured at the pre-submit screen. Null until proof is captured. Read it via GET /entities/{id}/filing_proof.

SHA-256 over the deterministic proof inputs only (canonicalized field-dump, AcroForm field values, and each ID-image source-byte hash). The determinism and tamper gate; folds into the daily audit anchor and is re-verified on every proof read.

SHA-256 over the raw screenshot and flattened-PDF bytes. Corroborating evidence only — allowed to drift with browser and toolchain versions, and excluded from the determinism gate.

The structured Blocker payload when state is blocked; null otherwise.

Unix timestamp when the run reached its structural stop or blocked. Null while transient.

Unix timestamp (seconds since epoch) when the run was created. Immutable.