Batch send

POST/api/v1/email/batch

Send up to 100 emails in one request. The body is a JSON array of send payloads (same fields as single send, minus attachments). Quota and daily limits are checked for the whole batch up front; then each item is processed independently.

curl -X POST https://www.noticeapi.com/api/v1/email/batch \
  -H "Authorization: Bearer ntc_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '[
    { "from": "Acme <[email protected]>", "to": "[email protected]",
      "subject": "Hi A", "text": "..." },
    { "from": "Acme <[email protected]>", "to": "[email protected]",
      "subject": "Hi B", "text": "..." }
  ]'

Per-item results

Results come back index-aligned — one suppressed recipient errors that item without failing the rest of the batch (unlike some providers that reject everything).

{
  "ok": true,
  "data": [
    { "id": "5f0c...", "messageId": "0f83..." },
    { "error": "Suppressed recipient(s): [email protected]", "code": "recipient_suppressed" }
  ]
}

Limits

100 items per call · 10 recipients per item · no attachments in batch · simulator recipients work per item. Idempotency keys are not yet supported on batch.