> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lifygo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Job Executions

> GET /jobs/{id}/executions — View execution history

# Job Executions

`GET /jobs/{id}/executions`

Returns the execution history for a scheduled job.

Each execution records whether the job succeeded or failed, how long it took, and any returned error.

***

## Endpoint

```http theme={null}
GET /jobs/{id}/executions
```

***

## Request

```bash theme={null}
curl http://localhost:8080/jobs/job_abc123/executions \
  -H "X-API-Key: lfy_your_key"
```

***

## Query Parameters

| Parameter | Type  | Default | Description               |
| --------- | ----- | ------: | ------------------------- |
| `limit`   | `int` |    `20` | Maximum number of results |
| `offset`  | `int` |     `0` | Pagination offset         |

***

## Successful Response

```json theme={null}
[
  {
    "id": "exec_xyz",
    "job_id": "job_abc123",
    "status": "success",
    "http_status": 200,
    "duration_ms": 312,
    "error_message": null,
    "executed_at": "2026-07-22T09:00:00Z"
  },
  {
    "id": "exec_xyz2",
    "job_id": "job_abc123",
    "status": "failed",
    "http_status": 500,
    "duration_ms": 89,
    "error_message": "connection refused",
    "executed_at": "2026-07-15T09:00:00Z"
  }
]
```

***

## Execution Statuses

| Status    | Description                                                  |
| --------- | ------------------------------------------------------------ |
| `success` | Job completed successfully                                   |
| `failed`  | Job encountered an error. Check `error_message` for details. |