Retrieve a run
One run: who, its status, the event that started it, each step it took with what happened (sent, received, timed_out, yes, no, updated, added...), and…
GET
https://app.usenotix.dev/api/v1/automations/{id}/runs/{runId}Full access and read only keys can call this. Sending access keys cannot. Key permissions lists the extra rules some calls have.
One run: who, its status, the event that started it, each step it took with what happened (sent, received, timed_out, yes, no, updated, added...), and the steps it skipped because it took another path.
Path parameters
idstringrequired
runIdstringrequired
Headers
Authorizationstringrequired
Bearer followed by your API key.
Errors
404
No such run in this automation for the calling team.
429
The team read automation runs 60 times in the last minute.
Every error has the same shape. See all error codes.
curl -X GET "https://app.usenotix.dev/api/v1/automations/<id>/runs/<runId>" \
-H "Authorization: Bearer $NOTIX_API_KEY"
Response200
{
"id": "cm1x8f3k20001qz7v5b9d2e4a",
"journeyId": "cm1x8f3k20001qz7v5b9d2e4a",
"status": "running",
"contact": {
"id": "cm1x8f3k20001qz7v5b9d2e4a",
"email": "customer@example.com",
"name": "Acme"
},
"path": "string",
"startedAt": "2026-10-01T09:00:00Z",
"updatedAt": "2026-10-01T09:00:00Z",
"currentStepId": "cm1x8f3k20001qz7v5b9d2e4a",
"timeline": [
{
"stepId": "cm1x8f3k20001qz7v5b9d2e4a",
"type": "string",
"outcome": "string",
"at": "2026-10-01T09:00:00Z",
"title": "string",
"text": "Thanks for your order."
}
],
"skipped": [
{
"stepId": "cm1x8f3k20001qz7v5b9d2e4a",
"type": "string",
"label": "string"
}
]
}