Order Supporting Form Status Updated

Event name: fundsub.order.supporting_form.status.updated

Note: Within a single supporting-document requirement (a "doc name", e.g. W-9), an investor can add and submit multiple online supporting forms. This event fires on each per-form status transition. It is distinct from fundsub.order.document.uploaded, which fires only when a submission produces an uploaded file and does not report intermediate lifecycle states.

Payload

{
  "event": string,
  "createdAt": string, // example: "2026-08-19T04:20:11.532Z"
  "fundId": string,
  "orderId": string,
  "formSubmissionId": string,
  "formName": string, // example: "W-8BEN"
  "docName": string, // example: "W-8 Form"
  "docGroup": string, // example: "Tax forms"
  "oldStatus": string, // example: "PENDING_SIGNATURE" — nullable
  "newStatus": string, // example: "COMPLETED"
  "submissionMethod": string // example: "FILL_AND_ESIGN" — nullable
}

Payload Fields

Field	Type	Description
event	string	The event identifier
createdAt	string	Timestamp when the event was sent (ISO 8601 UTC format)
fundId	string	The unique identifier of the fund
orderId	string	The unique identifier of the order (the LP id)
formSubmissionId	string	The unique identifier of the individual mini-form submission that changed
formName	string	The name of the mini form (e.g. `W-8BEN`)
docName	string	The name of the supporting-document requirement the form belongs to (e.g. `W-8 Form`)
docGroup	string	The group the supporting-document requirement belongs to (e.g. `Tax forms`)
oldStatus	string	The form's status before the transition. One of `NOT_STARTED`, `IN_PROGRESS`, `FORM_FILLED`, `PENDING_SIGNATURE`, `COMPLETED`, `null` when unspecified (e.g. no previous status).
newStatus	string	The form's status after the transition. One of `NOT_STARTED`, `IN_PROGRESS`, `FORM_FILLED`, `PENDING_SIGNATURE`, `COMPLETED`, `null` when unspecified.
submissionMethod	string	How the form was submitted. One of `FILL_AND_ESIGN`, `FILL_AND_SUBMIT_ONLINE`, `UPLOAD_OFFLINE`, `null` until the form has been submitted via one of those methods.

Status Values

Status	Meaning
NOT_STARTED	The form has not been started.
IN_PROGRESS	The LP has started the form and saved some information, but it is not yet complete.
FORM_FILLED	Every field is complete, but the form has not been submitted.
PENDING_SIGNATURE	The form has been submitted and is waiting on a signer. This state only occurs when a signature is required.
COMPLETED	The form is fully submitted and finished.

Submission Methods

Method	Meaning
FILL_AND_ESIGN	The LP filled the form online and completed it with an electronic signature.
FILL_AND_SUBMIT_ONLINE	The LP filled and submitted the form online (no signature required).
UPLOAD_OFFLINE	The LP uploaded a completed file rather than filling the form online.