API Reference

List Automation Runs

GET /automations/:id/runs — list the runs of an automation, with optional status filtering.

GET/automations/:id/runs

Lists the runs of an automation, newest first. Filter by one or more statuses with a comma-separated status query parameter.

Path parameters

idstringrequired

The ID of the automation.

Query parameters

statusstringoptional

Filter to one or more run statuses, comma-separated (e.g. status=running,completed). Possible values: running, completed, failed, cancelled, skipped.

All runs

import { MailBlastr } from 'mailblastr';

const mb = new MailBlastr('mb_xxxxxxxxx');

const { data, error } = await mb.automations.runs('c9b16d4f-ba6c-4e2e-b044-6bf4404e57fd');
console.log({ data, error });

Filter by status

import { MailBlastr } from 'mailblastr';

const mb = new MailBlastr('mb_xxxxxxxxx');

const { data, error } = await mb.automations.runs('c9b16d4f-ba6c-4e2e-b044-6bf4404e57fd', { status: running,completed });
console.log({ data, error });

Response

{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "object": "automation_run",
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "contact_id": "26e2b838-bf6d-4515-b6a7-17525b12b05a",
      "contact_email": "jordan@acme.com",
      "status": "completed",
      "started_at": "2026-10-01T12:00:00.000Z",
      "completed_at": "2026-10-01T12:05:00.000Z",
      "created_at": "2026-10-01T12:00:00.000Z"
    }
  ]
}