Retrieve one Schedule Run by ID.
GET /api/v1/forward/schedule_runs/{run_id}
Returns a single Schedule Run execution record. identity_id may be provided as an additional ownership constraint.
Headers
| Header | Required | Description |
|---|---|---|
Authorization | Yes | Bearer <PAT or SAT> |
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
run_id | string | Yes | Schedule Run ID. |
Query parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
identity_id | string | No | - | Optional additional ownership constraint. |
Example request
Example response
HTTP 200 OK
Response fields
Returns the complete Schedule Run object. Trigger context and error types are also defined in the shared schemas.
Errors
| HTTP | Type | Code | Trigger |
|---|---|---|---|
| 401 | authentication_error | authentication_required | PAT or SAT invalid or expired. |
| 404 | not_found_error | schedule_run_not_found | Run does not exist, is cross-tenant, or fails the identity_id constraint. |
Notes
error.type=concurrency_limit_reachedmeans a run was recorded but skipped due tomax_concurrent_runs.- Poll this endpoint until
statusenters a terminal state.

