Skip to content

Industries

Send Loan Agreements With a Preparer and Co-Borrower

Have a loan officer fill in the amount as a preparer, then collect a disclosure acknowledgment and signatures from the borrower and co-borrower in order.

A loan agreement carries terms that the lender fills in before the borrowers sign. Add the loan officer as a preparer who enters the amount, then route the document to the borrower and the co-borrower. The amount is also stored on the envelope, so your loan system can read it back.

Envelope shape

  • A preparer first. The loan officer is a preparer. Preparers fill in text inputs, checkboxes and dropdowns but cannot sign. See Preparer and Prepare before signing.
  • A text input with capture_as. The loan_amount place is a text_input assigned to the loan officer. capture_as: "loan_amount" stores the entered value in the envelope’s captures. See Capturing input.
  • A required disclosure checkbox. The borrower has a checkbox place with requirement: "required", so the borrower cannot finish without ticking it. See Checkbox places.
  • Two signers. The borrower and the co-borrower each have a signature place.
  • Opaque metadata. metadata.loan_ref points to the loan record in your system.

Routing

The envelope uses sequential routing: loan officer, then borrower, then co-borrower. Form places such as text inputs and checkboxes are accepted only on sequential envelopes. See Sequential signing.

Webhooks to listen for

  • recipient.completed: fires for the officer, the borrower and the co-borrower. Use recipient_key to update the stage of the application.
  • recipient.rejected: a party declined. Route the application back to the loan officer.
  • envelope.completed: all parties finished. Retrieve the envelope and read captures.loan_amount to reconcile the amount with your system.
  • deliverable.generated: download the signed agreement and audit log for the loan file.

Set up the endpoint as shown in Set up webhooks.

Compliance notes

This is general information, not legal advice. Lending is regulated, and the disclosures, consents and record retention you need depend on the product and the jurisdiction. Have counsel or your compliance team review the template and the flow. Keep account numbers and other sensitive values out of metadata, which appears in webhook payloads.

Default
POST /v1/envelopes HTTP/1.1
Host: api.signatureapi.com
X-API-Key: YOUR_API_KEY
Content-Type: application/json

{
  "title": "Personal Loan Agreement (sample)",
  "message": "Please review the loan terms and sign.",
  "routing": "sequential",
  "metadata": {
    "loan_ref": "loan_5120"
  },
  "topics": [
    "lending",
    "loan_agreements"
  ],
  "documents": [
    {
      "key": "loan_agreement",
      "url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
      "format": "pdf",
      "fixed_positions": [
        {
          "place_key": "loan_amount",
          "page": 1,
          "top": 140,
          "left": 210
        },
        {
          "place_key": "disclosures_ack",
          "page": 1,
          "top": 230,
          "left": 210
        },
        {
          "place_key": "borrower_signature",
          "page": 1,
          "top": 172,
          "left": 210
        },
        {
          "place_key": "coborrower_signature",
          "page": 1,
          "top": 186,
          "left": 220
        }
      ],
      "places": [
        {
          "key": "loan_amount",
          "type": "text_input",
          "recipient_key": "loan_officer",
          "prompt": "Loan amount",
          "width": 160,
          "capture_as": "loan_amount"
        },
        {
          "key": "disclosures_ack",
          "type": "checkbox",
          "recipient_key": "borrower",
          "requirement": "required",
          "capture_as": "disclosures_ack"
        },
        {
          "key": "borrower_signature",
          "type": "signature",
          "recipient_key": "borrower"
        },
        {
          "key": "coborrower_signature",
          "type": "signature",
          "recipient_key": "coborrower"
        }
      ]
    }
  ],
  "recipients": [
    {
      "type": "preparer",
      "key": "loan_officer",
      "name": "Sam Patel",
      "email": "sam.patel@example.com"
    },
    {
      "type": "signer",
      "key": "borrower",
      "name": "Jane Doe",
      "email": "jane.doe@example.com"
    },
    {
      "type": "signer",
      "key": "coborrower",
      "name": "John Smith",
      "email": "john.smith@example.com"
    }
  ]
}
{
  "id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
  "title": "Personal Loan Agreement (sample)",
  "label": null,
  "message": "Please review the loan terms and sign.",
  "status": "processing",
  "attestation": "none",
  "language": "en",
  "mode": "test",
  "routing": "sequential",
  "timezone": "UTC",
  "timestamp_format": "MM/DD/YYYY HH:mm:ss",
  "snapshot_url": null,
  "branding": {
    "logo": null,
    "accent_color": "#2463EB",
    "email": {
      "footer": null,
      "logo_position": "left",
      "from": "noreply@signatureapi.com"
    }
  },
  "deliverable": {
    "id": "del_HVl3Nj7XzTzX7jN3lVH5vn",
    "envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
    "name": null,
    "status": "pending",
    "type": "standard",
    "url": null,
    "password": null,
    "created_at": "2026-11-02T14:03:11.000Z",
    "generated_at": null,
    "timezone": "UTC",
    "language": "en",
    "timestamp_format": "MM/DD/YYYY HH:mm:ss",
    "included_documents": [
      "loan_agreement"
    ]
  },
  "metadata": {
    "loan_ref": "loan_5120"
  },
  "sender": {
    "name": "Acme Corp Legal",
    "email": "legal@acme.example",
    "organization": "Acme Corp"
  },
  "captures": {
    "disclosures_ack": false,
    "loan_amount": null
  },
  "documents": [
    {
      "id": "doc_HVl3Nj7XzTzX7jN3lVH5vn",
      "envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
      "key": "loan_agreement",
      "title": null,
      "page_count": 1,
      "url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
      "format": "pdf",
      "fixed_positions": [
        {
          "page": 1,
          "top": 140,
          "left": 210,
          "place_key": "loan_amount"
        },
        {
          "page": 1,
          "top": 230,
          "left": 210,
          "place_key": "disclosures_ack"
        },
        {
          "page": 1,
          "top": 172,
          "left": 210,
          "place_key": "borrower_signature"
        },
        {
          "page": 1,
          "top": 186,
          "left": 220,
          "place_key": "coborrower_signature"
        }
      ],
      "places": [
        {
          "key": "loan_amount",
          "type": "text_input",
          "recipient_key": "loan_officer",
          "capture_as": "loan_amount",
          "hint": null,
          "format": null,
          "prompt": "Loan amount",
          "requirement": "required",
          "format_message": null,
          "font_size": 12,
          "width": 160
        },
        {
          "key": "disclosures_ack",
          "type": "checkbox",
          "recipient_key": "borrower",
          "height": 20,
          "symbol": "check",
          "capture_as": "disclosures_ack",
          "requirement": "required"
        },
        {
          "key": "borrower_signature",
          "type": "signature",
          "recipient_key": "borrower",
          "height": 60
        },
        {
          "key": "coborrower_signature",
          "type": "signature",
          "recipient_key": "coborrower",
          "height": 60
        }
      ]
    }
  ],
  "recipients": [
    {
      "id": "re_HVl3Nj7XzTzX7jN3lVH5vn",
      "envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
      "type": "preparer",
      "key": "loan_officer",
      "email": "sam.patel@example.com",
      "name": "Sam Patel",
      "ceremony": {
        "authentication": [
          {
            "type": "email_link",
            "subject_override": null,
            "message_override": null
          }
        ],
        "embeddable_in": [],
        "redirect_url": null,
        "redirect_delay": 3,
        "url": null,
        "url_variant": "standard"
      },
      "ceremony_creation": "automatic",
      "delivery_type": "none",
      "status": "pending",
      "status_updated_at": "2026-11-02T14:03:11.000Z",
      "completed_at": null
    },
    {
      "id": "re_OcsAUqEe6a6eEqUAscOC2u",
      "envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
      "type": "signer",
      "key": "borrower",
      "email": "jane.doe@example.com",
      "name": "Jane Doe",
      "ceremony": {
        "authentication": [
          {
            "type": "email_link",
            "subject_override": null,
            "message_override": null
          }
        ],
        "embeddable_in": [],
        "redirect_url": null,
        "redirect_delay": 3,
        "url": null,
        "url_variant": "standard"
      },
      "ceremony_creation": "automatic",
      "delivery_type": "email",
      "signature_options": [
        "typed",
        "drawn"
      ],
      "status": "awaiting",
      "status_updated_at": "2026-11-02T14:03:11.000Z",
      "completed_at": null
    },
    {
      "id": "re_VjzHbxLlDhDlLxbHzjVJ91",
      "envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
      "type": "signer",
      "key": "coborrower",
      "email": "john.smith@example.com",
      "name": "John Smith",
      "ceremony": {
        "authentication": [
          {
            "type": "email_link",
            "subject_override": null,
            "message_override": null
          }
        ],
        "embeddable_in": [],
        "redirect_url": null,
        "redirect_delay": 3,
        "url": null,
        "url_variant": "standard"
      },
      "ceremony_creation": "automatic",
      "delivery_type": "email",
      "signature_options": [
        "typed",
        "drawn"
      ],
      "status": "awaiting",
      "status_updated_at": "2026-11-02T14:03:11.000Z",
      "completed_at": null
    }
  ],
  "topics": [
    "lending",
    "loan_agreements"
  ],
  "created_at": "2026-11-02T14:03:11.000Z",
  "completed_at": null
}

Errors every call can return are in Errors and Authentication.