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. Theloan_amountplace is atext_inputassigned to the loan officer.capture_as: "loan_amount"stores the entered value in the envelope’scaptures. See Capturing input. - A required disclosure checkbox. The borrower has a
checkboxplace withrequirement: "required", so the borrower cannot finish without ticking it. See Checkbox places. - Two signers. The borrower and the co-borrower each have a
signatureplace. - Opaque metadata.
metadata.loan_refpoints 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. Userecipient_keyto 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 readcaptures.loan_amountto 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.
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"
}
]
}npx signatureapi envelopes create --body - <<'EOF'
{
"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"
}
]
}
EOF{
"name": "create_envelope",
"arguments": {
"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
}{
"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 every call can return are in Errors and Authentication.