Skip to Content
SendlySendly
API ReferenceWorkflows

List a workflow's executions

GET
/api/v1/workflows/{id}/executions

One row per contact-run, newest first, cursor-paginated on the execution's start time. Filter by status to find stuck (WAITING) or failed runs.

Requires the workflows:read scope — View your automation workflows and their runs.

headerAuthorizationBearer <API Key>

API key authentication. Use a sk_* (FULL) or pk_* (SENDING_ONLY) key as the bearer token. Public keys (pk_*) are restricted to the email-send endpoints and the self-serve list subscribe/unsubscribe pair; every other endpoint — event tracking included — answers 403 for them. In scope terms (used by /api/v1/* operations): FULL keys hold every scope; SENDING_ONLY keys hold only emails:send.

id*string

Workflow id.

Formatuuid
limit?integer
Range1 <= value <= 100
Default20
after?string

Opaque cursor from a previous response's next_cursor.

Length1 <= length
status?string

Return only executions in this state.

Value in"RUNNING""WAITING""COMPLETED""EXITED""FAILED""CANCELLED"

Response Body

Execution list

application/json
  1. response

Cursor-paginated list of workflow executions, newest first.

data*array<>
has_more*boolean
next_cursor*|

Pass as after to fetch the next page. null on the last page.

Example Request
curl -X GET 'https://api.sendly.now/api/v1/workflows/497f6eca-6276-4993-bfeb-53cbbbba6f08/executions'
Example Response
{  "data": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "workflow_id": "03e70e31-d7a4-4401-a629-6a4b6096cdfe",      "contact_id": "f245e2a3-e141-4d41-912c-b1c1f5bd5598",      "status": "RUNNING",      "current_step_id": "7ea464a2-c5aa-44f1-a236-bca8c839d1c0",      "exit_reason": "string",      "started_at": "2019-08-24T14:15:22Z",      "completed_at": "2019-08-24T14:15:22Z"    }  ],  "has_more": true,  "next_cursor": "string"}