---
title: "Send Listing Agreements and Purchase Offers"
description: "Send a purchase agreement to a buyer and then a seller in order, with a signature and a completion date for each, and track the transaction by id."
canonical: "https://signatureapi.com/docs/use-cases/real-estate"
source: "https://signatureapi.com/docs/use-cases/real-estate.md"
last_verified_api_version: "1.18.0"
last_modified: "2026-11-18T17:35:55Z"
---

# Send Listing Agreements and Purchase Offers

Send a purchase agreement to a buyer and then a seller in order, with a signature and a completion date for each, and track the transaction by id.

_Last verified against API version 1.18.0._

A purchase agreement usually needs the buyer to sign first and the seller to respond afterward. Use sequential routing so the seller is invited only after the buyer has finished, and let SignatureAPI stamp each signer's completion date next to their signature.

## Envelope shape

- **Two signers, in order.** The buyer and the seller are both `signer` recipients. The order of the `recipients` array is the signing order.
- **A signature and a date per signer.** Each signer has a `signature` place and a `recipient_completed_date` place. The date is filled in with the moment that recipient finishes, formatted by `date_format`. See [Date places](https://signatureapi.com/docs/api/resources/places/date).
- **Places by fixed position.** The sample PDF has no `[[placeholders]]`, so each place is anchored with `fixed_positions`. See [Use fixed positions](https://signatureapi.com/docs/api/guides/how-to/use-fixed-positions).
- **Metadata and topics.** `metadata.transaction_id` ties the envelope to your transaction record and `topics` group it for filtering. See [Metadata](https://signatureapi.com/docs/api/resources/envelopes/metadata).

## Routing

The envelope uses `sequential` routing, which is also the default. The buyer receives the agreement first. The seller stays in `awaiting` status until the buyer completes. 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 after the buyer signs and again after the seller signs. Read `recipient_key` and `envelope_metadata.transaction_id` to update the right step of the transaction.
- [`recipient.rejected`](https://signatureapi.com/docs/api/resources/events/recipient-events): a party declined. Notify the agent and decide whether to replace the recipient or cancel the envelope.
- [`envelope.completed`](https://signatureapi.com/docs/api/resources/events/envelope-events): both parties have signed. Move the transaction to the next stage.
- [`deliverable.generated`](https://signatureapi.com/docs/api/resources/events/deliverable-events): download the signed agreement and attach it to the transaction 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. Rules for electronic signatures on real estate documents vary by jurisdiction and by document type, and some documents may need other formalities. Have counsel or your broker confirm what applies before you send.

### Example: Default

Residential Purchase Agreement (sample).

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

{
  "title": "Residential Purchase Agreement (sample)",
  "message": "Please review and sign the purchase agreement.",
  "routing": "sequential",
  "metadata": {
    "transaction_id": "txn_7731",
    "property_ref": "lot_12"
  },
  "topics": [
    "real_estate",
    "purchase"
  ],
  "documents": [
    {
      "key": "purchase_agreement",
      "url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
      "format": "pdf",
      "fixed_positions": [
        {
          "place_key": "buyer_signature",
          "page": 1,
          "top": 172,
          "left": 210
        },
        {
          "place_key": "buyer_date",
          "page": 1,
          "top": 172,
          "left": 420
        },
        {
          "place_key": "seller_signature",
          "page": 1,
          "top": 186,
          "left": 220
        },
        {
          "place_key": "seller_date",
          "page": 1,
          "top": 186,
          "left": 430
        }
      ],
      "places": [
        {
          "key": "buyer_signature",
          "type": "signature",
          "recipient_key": "buyer"
        },
        {
          "key": "buyer_date",
          "type": "recipient_completed_date",
          "recipient_key": "buyer",
          "date_format": "MMM D, YYYY"
        },
        {
          "key": "seller_signature",
          "type": "signature",
          "recipient_key": "seller"
        },
        {
          "key": "seller_date",
          "type": "recipient_completed_date",
          "recipient_key": "seller",
          "date_format": "MMM D, YYYY"
        }
      ]
    }
  ],
  "recipients": [
    {
      "type": "signer",
      "key": "buyer",
      "name": "Jane Doe",
      "email": "jane.doe@example.com"
    },
    {
      "type": "signer",
      "key": "seller",
      "name": "John Smith",
      "email": "john.smith@example.com"
    }
  ]
}
```

Response 201 Created:

```json
{
  "id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
  "title": "Residential Purchase Agreement (sample)",
  "label": null,
  "message": "Please review and sign the purchase agreement.",
  "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": [
      "purchase_agreement"
    ]
  },
  "metadata": {
    "transaction_id": "txn_7731",
    "property_ref": "lot_12"
  },
  "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": "purchase_agreement",
      "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": "buyer_signature"
        },
        {
          "page": 1,
          "top": 172,
          "left": 420,
          "place_key": "buyer_date"
        },
        {
          "page": 1,
          "top": 186,
          "left": 220,
          "place_key": "seller_signature"
        },
        {
          "page": 1,
          "top": 186,
          "left": 430,
          "place_key": "seller_date"
        }
      ],
      "places": [
        {
          "key": "buyer_signature",
          "type": "signature",
          "recipient_key": "buyer",
          "height": 60
        },
        {
          "key": "buyer_date",
          "type": "recipient_completed_date",
          "recipient_key": "buyer",
          "date_format": "MMM D, YYYY",
          "font_size": 12
        },
        {
          "key": "seller_signature",
          "type": "signature",
          "recipient_key": "seller",
          "height": 60
        },
        {
          "key": "seller_date",
          "type": "recipient_completed_date",
          "recipient_key": "seller",
          "date_format": "MMM D, YYYY",
          "font_size": 12
        }
      ]
    }
  ],
  "recipients": [
    {
      "id": "re_HVl3Nj7XzTzX7jN3lVH5vn",
      "envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
      "type": "signer",
      "key": "buyer",
      "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": "seller",
      "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": [
    "real_estate",
    "purchase"
  ],
  "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.
