Retrieve an email send

get/v1/email-sends/{send_id}

Request

Base URL: https://api-eu.dynamicdocumentapi.com
URL: https://api-eu.dynamicdocumentapi.com/v1/email-sends/{send_id}
Auth: one of:
- HTTP bearer
- API key in header X-API-Key

Path parameters

send_idstring required

Email send id (ems_…).

Response

attemptsinteger required

batch_idstring nullable required

bcc_countinteger required

cc_countinteger required

connection_idstring required

created_atstring date-time required

idstring required

mode'live' | 'sandbox' | 'redirect' | 'skip' required

live; for test renders the connection's test_mode (sandbox, redirect, skip); redirect for a rule test.

object'email_send' required

provider_message_idstring nullable required

The provider's id of the message; for SMTP the Message-ID we set. Microsoft 365 (graph) returns none.

render_idstring required

resend_ofstring nullable required

The send this one repeats (ems_…).

rule_idstring required

sandboxboolean required

Sent with Brevo's sandbox header: nothing is delivered.

sent_atstring date-time nullable required

skip_reason'condition_false' | 'test_mode' nullable required

unknown: the provider may have delivered it (e.g. a timeout after sending); it is never retried automatically: check the provider's logs (the message carries X-Dda-Send-Id) before resending.

subjectstring nullable required

template_idstring nullable required

testboolean required

tostring[] required

Example response

{
  "attachments": [
    {
      "bytes": 48213,
      "file_id": "file_01J9ZM1X3F7R8K2C4V6B8N0P2R",
      "filename": "R-2026-0042.pdf"
    }
  ],
  "connection_id": "emc_01J9ZK3M7Q8V5W2X4Y6Z8A0B1F",
  "error": {
    "code": "email_daily_cap_reached"
  },
  "id": "ems_01J9ZM1X3F7R8K2C4V6B8N0P2T",
  "render_id": "rnd_01J9ZM1X3F7R8K2C4V6B8N0P2Q",
  "rule_id": "emr_01J9ZK3M7Q8V5W2X4Y6Z8A0B1E",
  "template_id": "tpl_01J9ZK3M7Q8V5W2X4Y6Z8A0B1C"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.