Retrieve an automation run
curl --request GET \
--url https://api.sendrealm.com/automation-runs/{runId} \
--header 'Authorization: Bearer <token>'{
"data": {
"id": "run_123",
"automation_id": "aut_123",
"trigger_event_name": "order.completed",
"resolved_identity_type": "email",
"resolved_identity_value": "olivia@example.com",
"status": "completed",
"trigger_event": {
"id": "evt_123",
"event_name": "order.completed",
"payload": {
"order_id": "ord_123"
},
"occurred_at": "2026-06-08T14:15:00.000Z"
},
"steps": [
{
"id": "step_1",
"step_key": "send_receipt",
"step_type": "send_email_template",
"status": "completed",
"linked_emails": [
{
"id": "email_123",
"subject": "Your receipt",
"status": "sent",
"last_event": "send",
"template_version_id": "tmplver_email_123",
"contact_id": "contact_123",
"created_at": "2026-06-08T14:15:01.000Z"
}
]
},
{
"id": "step_2",
"step_key": "wait_for_open",
"step_type": "wait_for_event",
"status": "completed",
"branch_taken": "received",
"waits": [
{
"id": "wait_123",
"step_id": "step_2",
"step_key": "wait_for_open",
"step_type": "wait_for_event",
"waiting_for_event_name": "sendrealm.mail.open",
"status": "received",
"resolved_identity_value": "olivia@example.com",
"timeout_at": "2026-06-08T14:45:00.000Z",
"resumed_at": "2026-06-08T14:16:30.000Z",
"timed_out_at": null,
"outcome_branch": "received",
"resumed_by_event": {
"id": "evt_124",
"event_name": "sendrealm.mail.open",
"occurred_at": "2026-06-08T14:16:30.000Z"
}
}
]
}
],
"waits": [
{
"id": "wait_123",
"step_id": "step_2",
"step_key": "wait_for_open",
"step_type": "wait_for_event",
"waiting_for_event_name": "sendrealm.mail.open",
"status": "received",
"resolved_identity_value": "olivia@example.com",
"timeout_at": "2026-06-08T14:45:00.000Z",
"resumed_at": "2026-06-08T14:16:30.000Z",
"timed_out_at": null,
"outcome_branch": "received"
}
],
"sent_emails": [
{
"id": "email_123",
"subject": "Your receipt",
"status": "sent",
"last_event": "send",
"automation_step_key": "send_receipt",
"template_version_id": "tmplver_email_123",
"created_at": "2026-06-08T14:15:01.000Z"
}
]
}
}Automations
Retrieve Automation Run
Inspect a single automation run.
GET
/
automation-runs
/
{runId}
Retrieve an automation run
curl --request GET \
--url https://api.sendrealm.com/automation-runs/{runId} \
--header 'Authorization: Bearer <token>'{
"data": {
"id": "run_123",
"automation_id": "aut_123",
"trigger_event_name": "order.completed",
"resolved_identity_type": "email",
"resolved_identity_value": "olivia@example.com",
"status": "completed",
"trigger_event": {
"id": "evt_123",
"event_name": "order.completed",
"payload": {
"order_id": "ord_123"
},
"occurred_at": "2026-06-08T14:15:00.000Z"
},
"steps": [
{
"id": "step_1",
"step_key": "send_receipt",
"step_type": "send_email_template",
"status": "completed",
"linked_emails": [
{
"id": "email_123",
"subject": "Your receipt",
"status": "sent",
"last_event": "send",
"template_version_id": "tmplver_email_123",
"contact_id": "contact_123",
"created_at": "2026-06-08T14:15:01.000Z"
}
]
},
{
"id": "step_2",
"step_key": "wait_for_open",
"step_type": "wait_for_event",
"status": "completed",
"branch_taken": "received",
"waits": [
{
"id": "wait_123",
"step_id": "step_2",
"step_key": "wait_for_open",
"step_type": "wait_for_event",
"waiting_for_event_name": "sendrealm.mail.open",
"status": "received",
"resolved_identity_value": "olivia@example.com",
"timeout_at": "2026-06-08T14:45:00.000Z",
"resumed_at": "2026-06-08T14:16:30.000Z",
"timed_out_at": null,
"outcome_branch": "received",
"resumed_by_event": {
"id": "evt_124",
"event_name": "sendrealm.mail.open",
"occurred_at": "2026-06-08T14:16:30.000Z"
}
}
]
}
],
"waits": [
{
"id": "wait_123",
"step_id": "step_2",
"step_key": "wait_for_open",
"step_type": "wait_for_event",
"waiting_for_event_name": "sendrealm.mail.open",
"status": "received",
"resolved_identity_value": "olivia@example.com",
"timeout_at": "2026-06-08T14:45:00.000Z",
"resumed_at": "2026-06-08T14:16:30.000Z",
"timed_out_at": null,
"outcome_branch": "received"
}
],
"sent_emails": [
{
"id": "email_123",
"subject": "Your receipt",
"status": "sent",
"last_event": "send",
"automation_step_key": "send_receipt",
"template_version_id": "tmplver_email_123",
"created_at": "2026-06-08T14:15:01.000Z"
}
]
}
}Operational notes
- Run execution uses at-least-once semantics.
- Step retries are protected with step-level idempotency, so a previously completed step is not re-sent on resume.
wait_for_eventtimeout handling is scheduler based and near-real-time, not a hard real-time guarantee.- If a wait times out first, a later matching event does not reopen that completed branch.
⌘I