Skip to content

Industries

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.

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.
  • Places by fixed position. The sample PDF has no [[placeholders]], so each place is anchored with fixed_positions. See Use fixed positions.
  • Metadata and topics. metadata.transaction_id ties the envelope to your transaction record and topics group it for filtering. See 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.

Webhooks to listen for

  • recipient.completed: 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: a party declined. Notify the agent and decide whether to replace the recipient or cancel the envelope.
  • envelope.completed: both parties have signed. Move the transaction to the next stage.
  • deliverable.generated: download the signed agreement and attach it to the transaction file.

Set up the endpoint as shown in 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.

Default
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"
    }
  ]
}
{
  "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
}

Errors every call can return are in Errors and Authentication.