---
title: "Send Loan Agreements With a Preparer and Co-Borrower"
description: "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."
canonical: "https://signatureapi.com/docs/use-cases/lending"
source: "https://signatureapi.com/docs/use-cases/lending.md"
last_verified_api_version: "1.18.0"
last_modified: "2026-11-18T17:35:55Z"
---

# 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.

_Last verified against API version 1.18.0._

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](https://signatureapi.com/docs/api/resources/recipients/preparer) and [Prepare before signing](https://signatureapi.com/docs/api/guides/how-to/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](https://signatureapi.com/docs/api/resources/envelopes/captures).
- **A required disclosure checkbox.** The borrower has a `checkbox` place with `requirement: "required"`, so the borrower cannot finish without ticking it. See [Checkbox places](https://signatureapi.com/docs/api/resources/places/checkbox).
- **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](https://signatureapi.com/docs/api/guides/how-to/sequential-signing).

## Webhooks to listen for

- [`recipient.completed`](https://signatureapi.com/docs/api/resources/events/recipient-events): fires for the officer, the borrower and the co-borrower. Use `recipient_key` to update the stage of the application.
- [`recipient.rejected`](https://signatureapi.com/docs/api/resources/events/recipient-events): a party declined. Route the application back to the loan officer.
- [`envelope.completed`](https://signatureapi.com/docs/api/resources/events/envelope-events): all parties finished. Retrieve the envelope and read `captures.loan_amount` to reconcile the amount with your system.
- [`deliverable.generated`](https://signatureapi.com/docs/api/resources/events/deliverable-events): download the signed agreement and audit log for the loan file.

Set up the endpoint as shown in [Set up webhooks](https://signatureapi.com/docs/api/guides/how-to/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.

### Example: Default

Personal Loan Agreement (sample).

```http
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"
    }
  ]
}
```

Response 201 Created:

```json
{
  "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
}
```

Response 422 Unprocessable Content:

```json
{
  "type": "https://signatureapi.com/docs/v1/errors/validation-error",
  "title": "Validation Error",
  "status": 422,
  "detail": "The request body contains validation errors.",
  "errors": [
    "recipients[0].email must be a valid email address"
  ]
}
```

Errors that any request can return (authentication, rate limits, server errors) are on the [Errors](https://signatureapi.com/docs/api/errors) and [Authentication](https://signatureapi.com/docs/api/authentication) pages.
