Recipient Routing

When sending an envelope for signatures, you can control how it’s sent to recipients using the routing property in the Envelope. There are two options: Sequential and Parallel. By default, SignatureAPI uses parallel routing.

​

Parallel Routing

With Parallel Routing, the envelope is sent to all recipients at the same time. Each recipient can sign the document whenever they want, and there is no required signing order.

Key Points:

• All recipients receive the envelope simultaneously.
• They can sign in any order.
• Best for cases where the signing order doesn’t matter.

​

Sequential Routing

With Sequential Routing, the envelope is sent to one recipient at a time, in the order you specify in the envelope’s recipient array. The next recipient only receives the document after the previous one has signed.

Key Points:

• Recipients sign in the order set in the envelope’s recipient array.
• The envelope is sent to the next recipient only after the previous one signs.
• Ideal for workflows where the order of signatures matters.

​

Setting the Envelope’s Routing

By default, envelopes are sent in Parallel. If you need a specific signing order, set routing to Sequential.

// POST https://api.signatureapi.com/v1/envelopes
// X-API-Key: key_test_...
{
  "title": "Dummy Agreement",
  "label": "Dummy Agreement for Order Ref. 25005",
  "routing": "sequential",
  "message": "Please review the agreement at your convenience and provide your electronic signature.",
  "metadata": {
    //...
  },
  "documents": [
    //...
  ],
  "recipients": [
    //...
  ]
}