Reten Docs
Activities

Status Events

Get the status event history for an activity.

GET /api/activities/:id/status-events

Returns the complete audit trail of status transitions for an activity.

Auth: Required — VIEW_ACTIVITIES permission

Path Parameters

ParameterTypeDescription
idUUIDActivity ID

Example

curl https://api.reten.ai/api/activities/ee0e8400-e29b-41d4-a716-446655440000/status-events \
  -H "Authorization: Bearer <token>" \
  -H "x-tenant-id: <tenant-id>"
import axios from 'axios';

const response = await axios.get(
  'https://api.reten.ai/api/activities/ee0e8400-e29b-41d4-a716-446655440000/status-events',
  {
    headers: {
      Authorization: 'Bearer <token>',
      'x-tenant-id': '<tenant-id>',
    },
  }
);

const statusEvents = response.data;

Response 200 OK

[
  {
    "id": "ff0e8400-e29b-41d4-a716-446655440000",
    "eventType": "CREATED",
    "fromStatus": null,
    "toStatus": "READY",
    "errorCode": null,
    "errorMessage": null,
    "occurredAt": "2025-01-15T10:30:00.000Z"
  },
  {
    "id": "ff1e8400-e29b-41d4-a716-446655440001",
    "eventType": "DISPATCH_SUCCESS",
    "fromStatus": "READY",
    "toStatus": "DISPATCHED",
    "errorCode": null,
    "errorMessage": null,
    "occurredAt": "2025-01-15T10:31:00.000Z"
  }
]