> ## Documentation Index
> Fetch the complete documentation index at: https://signatureapi-daf4ee54.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Recipient routing

> Control signing order with sequential or parallel recipient routing options

The `routing` property controls the order in which recipients receive and act on the envelope. Two options are available: `sequential` and `parallel`. The default is `sequential`.

## Sequential routing

With sequential routing, the envelope is delivered to one recipient at a time, in the order listed in the `recipients` array. Each recipient must complete their part before the next one is notified.

<img src="https://mintcdn.com/signatureapi-daf4ee54/to2kcqhpCDnABjF5/docs/images/routing-sequential.png?fit=max&auto=format&n=to2kcqhpCDnABjF5&q=85&s=af83f68d1771d00c3b8905239bd143f5" alt="" width="606" height="129" data-path="docs/images/routing-sequential.png" />

* Recipients act in the order defined in the `recipients` array.
* Each recipient must complete before the next one is notified.
* Recipients acting later can see signatures and data entered by those who acted before them.
* Recipients waiting for a previous recipient will have a status of `awaiting`.
* Use this when the order of signatures matters.

## Parallel routing

With parallel routing, all recipients receive the envelope at the same time and can act in any order.

<img src="https://mintcdn.com/signatureapi-daf4ee54/to2kcqhpCDnABjF5/docs/images/routing-parallel.png?fit=max&auto=format&n=to2kcqhpCDnABjF5&q=85&s=78153c0585876ae351fa142f3274be37" alt="" width="380" height="378" data-path="docs/images/routing-parallel.png" />

* All recipients are notified simultaneously.
* Recipients can act in any order.
* Use this when signing order does not matter.

## Setting routing on an envelope

Set the `routing` property when creating an envelope. If omitted, sequential routing is used.

```json theme={null}
// POST https://api.signatureapi.com/v1/envelopes
// X-API-Key: key_test_...
// Content-Type: application/json

{
  "title": "Service Agreement",
  "routing": "parallel",
  "documents": [
    //...
  ],
  "recipients": [
    //...
  ]
}
```
