Bankruptcy Correspondence Mailing Packets API reference

PostalForm uses the same workflow definition for this API reference and its guided browser form. Fetch the live schema, collect the active required fields and attachments, and validate the completed request. Review the generated PDF, resolved recipient, mailing service and price with the owner before authorizing payment.

Send a top-level form instead of pdf or letter; those three document sources are mutually exclusive. Workflow forms are letters, not postcards. The machine envelope requires buyer, sender and recipient fields. For predefined or computed recipients, the server binds the final recipient to the workflow rules. Inspect the resolved recipient returned by validation; do not substitute a convenient office address.

The template below is structural, not ready to submit: replace every placeholder, complete the active fields, omit unused optional attachments, and use the field options and visibility rules in the schema. Empty strings and unchecked checkboxes are not user answers. Never infer a signature, legal eligibility, factual declaration or consent from a default value.

{
  "request_id": "<new UUID; preserve on retry>",
  "buyer_name": "<buyer name>",
  "buyer_email": "<buyer email>",
  "sender_name": "<sender name>",
  "sender_address_type": "Manual",
  "sender_address_manual": {
    "line1": "<street address>",
    "city": "<city>",
    "state": "<state or region>",
    "zip": "<postal code>",
    "countryCode": "US"
  },
  "recipient_name": "<confirmed recipient name>",
  "recipient_address_type": "Manual",
  "recipient_address_manual": {
    "line1": "<street address>",
    "city": "<city>",
    "state": "<state or region>",
    "zip": "<postal code>",
    "countryCode": "US"
  },
  "mail_class": "standard",
  "double_sided": true,
  "color": false,
  "certified": false,
  "form": {
    "slug": "bankruptcy-correspondence-packets",
    "fields": {
      "recipient_type": "",
      "document_type": "",
      "document_title": "",
      "case_status": "",
      "debtor_or_estate_name": "",
      "case_number": "",
      "bankruptcy_chapter": "",
      "sender_name": "",
      "sender_role": "",
      "sender_address": "",
      "recipient_company_name": "",
      "recipient_name": "",
      "recipient_address": "",
      "response_or_filing_deadline": "",
      "packet_notes": "",
      "mail_acceptance_acknowledged": false,
      "requirements_acknowledged": false,
      "no_physical_enclosures_acknowledged": false,
      "privacy_acknowledged": false,
      "not_filed_acknowledged": false,
      "not_legal_advice_acknowledged": false
    },
    "attachments": [
      {
        "id": "primary_document",
        "file_name": "<filename>",
        "base64": "<base64 file content>"
      },
      {
        "id": "supporting_documents",
        "file_name": "<filename>",
        "base64": "<base64 file content>"
      }
    ]
  }
}

Compound fields use nested objects keyed by subfield ID. Evaluate group and field visibility before deciding which fields are active. Conditional requirements, validation rules, recipient rules, attachment formats and compliance policies are preserved in the complete schema below.

{
  "schema_version": 1,
  "workflow_version": 1,
  "slug": "bankruptcy-correspondence-packets",
  "name": "Bankruptcy Correspondence Mailing Packets",
  "description": "Upload completed bankruptcy correspondence or court documents and mail them to a verified court, trustee, creditor, or other recipient.",
  "agent_summary": "Collect a completed bankruptcy-related primary PDF, optional supporting documents, recipient type, document purpose, existing-case details, debtor or estate name, optional chapter, sender and recipient addresses, deadline context, and acknowledgements for mail acceptance, privacy redaction, filing and service requirements, and the limits of PostalForm. Do not prepare bankruptcy forms, advise whether to file bankruptcy, or claim that mailing completes filing, service, a claim, or deadline compliance.",
  "form_summary": "Use this upload-first workflow for completed bankruptcy-related documents you already prepared. Enter the verified recipient, add optional exhibits, confirm privacy and local requirements, and review the packet before checkout.",
  "data_collected": [
    "Bankruptcy recipient type and completed document purpose",
    "Debtor or estate name, optional chapter, case status, and optional case number",
    "Sender name and return mailing address",
    "Bankruptcy court, trustee, creditor, law office, or other verified recipient and address",
    "Optional deadline and handling notes",
    "Primary document PDF, optional supporting documents, and required bankruptcy-process acknowledgements"
  ],
  "topics": [
    "bankruptcy",
    "bankruptcy court",
    "trustees",
    "creditors",
    "legal correspondence",
    "court documents"
  ],
  "category": "uploaded_document_packet",
  "publish_state": "published",
  "aliases": [
    "mail-bankruptcy-documents",
    "bankruptcy-document-mailing-packet",
    "mail-bankruptcy-correspondence"
  ],
  "llms": true,
  "indexable": true,
  "certified_mail": "optional",
  "recipient": {
    "mode": "user"
  },
  "checkout_flow": "forms_order",
  "published_at": "2026-07-10",
  "updated_at": "2026-07-11",
  "groups": [
    {
      "id": "document",
      "label": "Completed bankruptcy document",
      "description": "Identify the already-prepared document you want printed and mailed.",
      "depends_on": []
    },
    {
      "id": "case",
      "label": "Case details",
      "description": "Add the details needed to identify an existing bankruptcy case or recipient matter.",
      "depends_on": []
    },
    {
      "id": "sender",
      "label": "Sender",
      "description": "Enter the person or organization sending this packet.",
      "depends_on": []
    },
    {
      "id": "recipient",
      "label": "Bankruptcy recipient",
      "description": "Enter the exact verified court, trustee, creditor, attorney, or other recipient.",
      "depends_on": []
    },
    {
      "id": "timing",
      "label": "Deadline and handling",
      "description": "Record timing, privacy, or follow-up details for your final review.",
      "depends_on": []
    },
    {
      "id": "review",
      "label": "Review acknowledgements",
      "description": "Confirm the bankruptcy process requirements and workflow limits.",
      "depends_on": []
    }
  ],
  "fields": [
    {
      "id": "recipient_type",
      "label": "Who should receive this packet?",
      "type": "select",
      "required": true,
      "meta_class": null,
      "ui_width": null,
      "group_id": "document",
      "choice_group": null,
      "choice_label": null,
      "depends_on": [],
      "options": [
        "Bankruptcy court or clerk",
        "Case trustee",
        "United States Trustee office",
        "Creditor or claimant",
        "Creditor's attorney or law office",
        "Debtor or debtor's attorney",
        "Other bankruptcy-related recipient"
      ],
      "compound": null
    },
    {
      "id": "document_type",
      "label": "Completed document or correspondence type",
      "type": "select",
      "required": true,
      "meta_class": null,
      "ui_width": null,
      "group_id": "document",
      "choice_group": null,
      "choice_label": null,
      "depends_on": [],
      "options": [
        "Completed court form or filing",
        "Motion, response, objection, or notice",
        "Trustee request or response",
        "Creditor or claim-related correspondence",
        "Debtor or attorney correspondence",
        "Evidence, records, or supporting documents",
        "Other completed bankruptcy correspondence"
      ],
      "compound": null
    },
    {
      "id": "document_title",
      "label": "Document or packet title",
      "type": "text",
      "required": true,
      "meta_class": null,
      "ui_width": null,
      "group_id": "document",
      "choice_group": null,
      "choice_label": null,
      "depends_on": [],
      "compound": null
    },
    {
      "id": "case_status",
      "label": "Is this connected to an existing bankruptcy case?",
      "type": "select",
      "required": true,
      "meta_class": null,
      "ui_width": null,
      "group_id": "case",
      "choice_group": null,
      "choice_label": null,
      "depends_on": [],
      "options": [
        "Yes — an existing case",
        "No or not yet assigned",
        "Not sure or not applicable"
      ],
      "compound": null
    },
    {
      "id": "debtor_or_estate_name",
      "label": "Debtor or bankruptcy estate name",
      "type": "text",
      "required": true,
      "meta_class": null,
      "ui_width": null,
      "group_id": "case",
      "choice_group": null,
      "choice_label": null,
      "depends_on": [],
      "compound": null
    },
    {
      "id": "case_number",
      "label": "Bankruptcy case number",
      "type": "text",
      "required": true,
      "meta_class": null,
      "ui_width": null,
      "group_id": "case",
      "choice_group": null,
      "choice_label": null,
      "visibility": {
        "fieldId": "case_status",
        "operator": "equals",
        "value": "Yes — an existing case"
      },
      "depends_on": [
        "case_status"
      ],
      "compound": null
    },
    {
      "id": "bankruptcy_chapter",
      "label": "Bankruptcy chapter (optional)",
      "type": "select",
      "required": false,
      "meta_class": null,
      "ui_width": null,
      "group_id": "case",
      "choice_group": null,
      "choice_label": null,
      "depends_on": [],
      "options": [
        "Chapter 7",
        "Chapter 9",
        "Chapter 11",
        "Chapter 12",
        "Chapter 13",
        "Chapter 15",
        "Unknown or not applicable"
      ],
      "compound": null
    },
    {
      "id": "sender_name",
      "label": "Sender full name or organization",
      "type": "text",
      "required": true,
      "meta_class": "name",
      "ui_width": null,
      "group_id": "sender",
      "choice_group": null,
      "choice_label": null,
      "depends_on": [],
      "compound": null
    },
    {
      "id": "sender_role",
      "label": "Sender role (optional)",
      "type": "text",
      "required": false,
      "placeholder": "Example: debtor, creditor, claimant, or authorized representative",
      "meta_class": null,
      "ui_width": null,
      "group_id": "sender",
      "choice_group": null,
      "choice_label": null,
      "depends_on": [],
      "compound": null
    },
    {
      "id": "sender_address",
      "label": "Return mailing address",
      "type": "address",
      "required": true,
      "meta_class": null,
      "ui_width": null,
      "group_id": "sender",
      "choice_group": null,
      "choice_label": null,
      "depends_on": [],
      "compound": null
    },
    {
      "id": "recipient_company_name",
      "label": "Court, trustee office, creditor, firm, or recipient organization",
      "type": "text",
      "required": true,
      "meta_class": null,
      "ui_width": null,
      "group_id": "recipient",
      "choice_group": null,
      "choice_label": null,
      "depends_on": [],
      "compound": null
    },
    {
      "id": "recipient_name",
      "label": "Clerk, trustee, attorney, department, or attention line",
      "type": "text",
      "required": true,
      "meta_class": null,
      "ui_width": null,
      "group_id": "recipient",
      "choice_group": null,
      "choice_label": null,
      "depends_on": [],
      "compound": null
    },
    {
      "id": "recipient_address",
      "label": "Verified recipient mailing address",
      "type": "address",
      "required": true,
      "meta_class": null,
      "ui_width": null,
      "group_id": "recipient",
      "choice_group": null,
      "choice_label": null,
      "depends_on": [],
      "compound": null
    },
    {
      "id": "response_or_filing_deadline",
      "label": "Filing, response, claim, or delivery deadline (optional)",
      "type": "date",
      "required": false,
      "meta_class": "date",
      "ui_width": "half",
      "group_id": "timing",
      "choice_group": null,
      "choice_label": null,
      "depends_on": [],
      "compound": null
    },
    {
      "id": "packet_notes",
      "label": "Packet and follow-up notes (optional)",
      "type": "textarea",
      "required": false,
      "meta_class": null,
      "ui_width": null,
      "group_id": "timing",
      "choice_group": null,
      "choice_label": null,
      "depends_on": [],
      "compound": null
    },
    {
      "id": "mail_acceptance_acknowledged",
      "label": "I verified that this recipient accepts this document by mail and confirmed the correct address.",
      "type": "checkbox",
      "required": true,
      "meta_class": null,
      "ui_width": null,
      "group_id": "review",
      "choice_group": null,
      "choice_label": null,
      "depends_on": [],
      "compound": null
    },
    {
      "id": "requirements_acknowledged",
      "label": "I reviewed current requirements for signatures, declarations, copies, fees, formatting, filing, service, and deadlines.",
      "type": "checkbox",
      "required": true,
      "meta_class": null,
      "ui_width": null,
      "group_id": "review",
      "choice_group": null,
      "choice_label": null,
      "depends_on": [],
      "compound": null
    },
    {
      "id": "no_physical_enclosures_acknowledged",
      "label": "I confirmed this submission requires no cashier's check or money order, wet-ink original, self-addressed return envelope, or extra physical copy that is not already printable in my upload.",
      "type": "checkbox",
      "required": true,
      "meta_class": null,
      "ui_width": null,
      "group_id": "review",
      "choice_group": null,
      "choice_label": null,
      "depends_on": [],
      "compound": null
    },
    {
      "id": "privacy_acknowledged",
      "label": "I reviewed the packet for protected personal identifiers and applied the privacy and redaction rules that govern this submission.",
      "type": "checkbox",
      "required": true,
      "meta_class": null,
      "ui_width": null,
      "group_id": "review",
      "choice_group": null,
      "choice_label": null,
      "depends_on": [],
      "compound": null
    },
    {
      "id": "not_filed_acknowledged",
      "label": "I understand mailing and delivery do not prove filing, service, claim allowance, court acceptance, or docketing, and I will verify status separately.",
      "type": "checkbox",
      "required": true,
      "meta_class": null,
      "ui_width": null,
      "group_id": "review",
      "choice_group": null,
      "choice_label": null,
      "depends_on": [],
      "compound": null
    },
    {
      "id": "not_legal_advice_acknowledged",
      "label": "I understand PostalForm does not prepare or review bankruptcy documents and does not provide legal advice.",
      "type": "checkbox",
      "required": true,
      "meta_class": null,
      "ui_width": null,
      "group_id": "review",
      "choice_group": null,
      "choice_label": null,
      "depends_on": [],
      "compound": null
    }
  ],
  "attachments": [
    {
      "id": "primary_document",
      "label": "Completed bankruptcy document or correspondence",
      "required": true,
      "instructions": "Upload one final PDF containing the completed primary document. Confirm signatures, case details, privacy redactions, and formatting before uploading.",
      "allowed_types": [
        "pdf"
      ],
      "max_files": 1,
      "max_size_mb": 12
    },
    {
      "id": "supporting_documents",
      "label": "Exhibits and supporting documents",
      "required": false,
      "instructions": "Upload cover sheets, certificates, declarations, claim materials, exhibits, or other documents that should follow the primary document, in print order.",
      "allowed_types": [
        "pdf",
        "jpg",
        "jpeg",
        "png"
      ],
      "max_files": 20,
      "max_size_mb": 12
    }
  ],
  "attachments_max_total_size_mb": 12,
  "machine_submission": {
    "payload_property": "form",
    "create_paths": {
      "x402": "/api/machine/orders",
      "mpp": "/api/machine/mpp/orders"
    }
  }
}

Validation does not mail the document. For a human checkout, use MCP postalform.create_form_order_draft and present the returned preview, total and checkout URL. Machine API clients must handle the returned MPP or x402 challenge only within owner-approved spending authority. Preserve request_id and the exact payload for retries; changing the content requires a new request ID. After an uncertain payment, retrieve order status before creating another order. Provider handoff is not USPS delivery.