Skip to content

Industries

Send Residential Leases and Renewals

Send a lease to two tenants and a landlord representative at the same time, with signatures and per-tenant initials, and tag new leases and renewals.

A lease often has several parties who do not need to sign in a set order. Send the envelope to everyone at once with parallel routing, so a slow tenant does not hold up the landlord, and collect initials on pages such as the pet policy.

Envelope shape

  • Three signers. Two tenants and the landlord representative are signer recipients, each with a signature place.
  • Initials per tenant. Each tenant also has an initials place. See Initials places.
  • Places by fixed position. The sample PDF has no [[placeholders]], so every place is anchored with fixed_positions. See Use fixed positions.
  • Metadata and topics. metadata.lease_id and metadata.unit identify the lease. topics such as new_leases and a renewal topic let you filter by lease type. See Topics.

Routing

The envelope uses parallel routing. Every recipient is notified at once and can sign in any order. Parallel routing accepts only signing recipient types, so approvers and preparers need sequential routing. See Parallel signing.

Webhooks to listen for

  • recipient.completed: fires once per party. Read recipient_key and envelope_metadata.lease_id to show which parties are still outstanding.
  • recipient.rejected: a party declined. Alert the property manager, who can replace the recipient or cancel the envelope.
  • envelope.completed: every party has signed. Mark the lease as executed.
  • deliverable.generated: download the signed lease and store it with the tenancy record.

Set up the endpoint as shown in Set up webhooks.

Compliance notes

This is general information, not legal advice. Whether a residential lease or a renewal can be signed electronically, and what disclosures it must carry, depends on local law. Have counsel review your lease template and process.

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

{
  "title": "Residential Lease (sample)",
  "message": "Please review and sign the lease. Everyone can sign in any order.",
  "routing": "parallel",
  "metadata": {
    "lease_id": "lease_3310",
    "unit": "unit_4b"
  },
  "topics": [
    "leasing",
    "new_leases"
  ],
  "documents": [
    {
      "key": "lease",
      "url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
      "format": "pdf",
      "fixed_positions": [
        {
          "place_key": "tenant_one_signature",
          "page": 1,
          "top": 172,
          "left": 210
        },
        {
          "place_key": "tenant_two_signature",
          "page": 1,
          "top": 214,
          "left": 210
        },
        {
          "place_key": "landlord_signature",
          "page": 1,
          "top": 186,
          "left": 220
        },
        {
          "place_key": "tenant_one_initials",
          "page": 1,
          "top": 250,
          "left": 72
        },
        {
          "place_key": "tenant_two_initials",
          "page": 1,
          "top": 250,
          "left": 140
        }
      ],
      "places": [
        {
          "key": "tenant_one_signature",
          "type": "signature",
          "recipient_key": "tenant_one"
        },
        {
          "key": "tenant_two_signature",
          "type": "signature",
          "recipient_key": "tenant_two"
        },
        {
          "key": "landlord_signature",
          "type": "signature",
          "recipient_key": "landlord"
        },
        {
          "key": "tenant_one_initials",
          "type": "initials",
          "recipient_key": "tenant_one",
          "height": 30
        },
        {
          "key": "tenant_two_initials",
          "type": "initials",
          "recipient_key": "tenant_two",
          "height": 30
        }
      ]
    }
  ],
  "recipients": [
    {
      "type": "signer",
      "key": "tenant_one",
      "name": "Jane Doe",
      "email": "jane.doe@example.com"
    },
    {
      "type": "signer",
      "key": "tenant_two",
      "name": "John Smith",
      "email": "john.smith@example.com"
    },
    {
      "type": "signer",
      "key": "landlord",
      "name": "Maria Garcia",
      "email": "maria.garcia@example.com"
    }
  ]
}
{
  "id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
  "title": "Residential Lease (sample)",
  "label": null,
  "message": "Please review and sign the lease. Everyone can sign in any order.",
  "status": "processing",
  "attestation": "none",
  "language": "en",
  "mode": "test",
  "routing": "parallel",
  "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": [
      "lease"
    ]
  },
  "metadata": {
    "lease_id": "lease_3310",
    "unit": "unit_4b"
  },
  "sender": {
    "name": "Acme Corp Legal",
    "email": "legal@acme.example",
    "organization": "Acme Corp"
  },
  "captures": {},
  "documents": [
    {
      "id": "doc_HVl3Nj7XzTzX7jN3lVH5vn",
      "envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
      "key": "lease",
      "title": null,
      "page_count": 1,
      "url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
      "format": "pdf",
      "fixed_positions": [
        {
          "page": 1,
          "top": 172,
          "left": 210,
          "place_key": "tenant_one_signature"
        },
        {
          "page": 1,
          "top": 214,
          "left": 210,
          "place_key": "tenant_two_signature"
        },
        {
          "page": 1,
          "top": 186,
          "left": 220,
          "place_key": "landlord_signature"
        },
        {
          "page": 1,
          "top": 250,
          "left": 72,
          "place_key": "tenant_one_initials"
        },
        {
          "page": 1,
          "top": 250,
          "left": 140,
          "place_key": "tenant_two_initials"
        }
      ],
      "places": [
        {
          "key": "tenant_one_signature",
          "type": "signature",
          "recipient_key": "tenant_one",
          "height": 60
        },
        {
          "key": "tenant_two_signature",
          "type": "signature",
          "recipient_key": "tenant_two",
          "height": 60
        },
        {
          "key": "landlord_signature",
          "type": "signature",
          "recipient_key": "landlord",
          "height": 60
        },
        {
          "key": "tenant_one_initials",
          "type": "initials",
          "recipient_key": "tenant_one",
          "height": 30
        },
        {
          "key": "tenant_two_initials",
          "type": "initials",
          "recipient_key": "tenant_two",
          "height": 30
        }
      ]
    }
  ],
  "recipients": [
    {
      "id": "re_HVl3Nj7XzTzX7jN3lVH5vn",
      "envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
      "type": "signer",
      "key": "tenant_one",
      "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": "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": "tenant_two",
      "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": "pending",
      "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": "landlord",
      "email": "maria.garcia@example.com",
      "name": "Maria Garcia",
      "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": "pending",
      "status_updated_at": "2026-11-02T14:03:11.000Z",
      "completed_at": null
    }
  ],
  "topics": [
    "leasing",
    "new_leases"
  ],
  "created_at": "2026-11-02T14:03:11.000Z",
  "completed_at": null
}

Errors every call can return are in Errors and Authentication.