> ## Documentation Index
> Fetch the complete documentation index at: https://docs.syntr.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Batch Transactional distribution

> Execute a batch of transactional messages. You may provide a specific 'emails' array for unique payloads per user, or a 'list_id' to target an entire segment with 'common_params'.

### Request Body

<ParamField body="emails" type="array">
  List of individual messages: \[\{to, recipient\_id, params, name}]
</ParamField>

<ParamField body="list_id" type="string">
  Fetch all recipients from a specific list.
</ParamField>

<ParamField body="template_id" type="string" required>
  REQUIRED. The design asset to use for this batch.
</ParamField>

<ParamField body="common_params" type="object">
  Global merge tags shared by all batch recipients.
</ParamField>

<RequestExample>
  ```json Request theme={null}
  {
    "list_id": "a0ee-9c0b-1122",
    "template_id": "8c7d-bcde-1122",
    "common_params": {
      "site_url": "https://syntr.io"
    }
  }
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "data": {
      "total": 100,
      "sent": 98,
      "failed": 2,
      "details": []
    },
    "message": "Batch processing complete."
  }
  ```
</ResponseExample>