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.

GET/api/jobs/{jobId}
X-API-Key<token>

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

jobId*string

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"}