Get Job Status
Poll an execution by its execution ID: the jobId from an async receipt, or the executionId from a pending receipt or an X-Execution-Id header. Statuses are pending, processing, paused, completed, failed, and cancelled. The same API key that started the run can poll it. After the run's execution record expires (7 days after it finishes on SteelEngine Cloud), the status comes from run history: metadata.source is run-history and output is the run-history copy. Once run history is deleted (30 days on SteelEngine Cloud), the lookup returns 404.
/api/jobs/{jobId}Authorization
apiKey Your SteelEngine API key (personal, workspace, or organization). Create personal and workspace keys under Settings > API Keys. Create organization keys under Organization Settings > API Keys.
In: header
Path Parameters
The execution ID (returned as jobId in the async receipt).
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/jobs/string"{ "success": true, "taskId": "exec_abc123", "jobId": "exec_abc123", "status": "completed", "metadata": { "workflowId": "wf_1a2b3c4d5e", "workspaceId": "wsp_abc123", "userId": "usr_x", "executionId": "exec_abc123", "startTime": "2026-01-15T10:30:00Z", "endTime": "2026-01-15T10:30:01Z", "duration": 1250 }, "output": { "content": "Done" }, "startedAt": "2026-01-15T10:30:00Z", "completedAt": "2026-01-15T10:30:01Z", "executedAt": "2026-01-15T10:30:01Z"}