# GET /jobs/scheduled

Section: [Scheduled jobs](https://appengine.appmint.io/documentation/tag/scheduled-jobs.md) · Full index: https://appengine.appmint.io/documentation.md
## GET /jobs/scheduled

**List scheduled jobs**

`operationId: ScheduledJobsController_list`

Every recurring job this server runs, for this org: its settings (enabled, time or interval, time zone), the schedule it is on, whether it is queued, the next run and the last run. Runs are spread per business: an interval job runs on a minute offset fixed for this org (every 5 minutes may be `3-59/5`), and a daily job left on its default time runs at a fixed minute up to half an hour after it (`time` shows the real time; a time the business sets is kept exactly). `lastRun` is the last time the job ran or checked: a scheduled run that found nothing (`summary.processed` 0, no errors) writes no `job` record, so `lastRun.jobId` is absent for it. `inUse` says whether the org uses the job (it is scheduled only then). Each run is also a `job` record: GET /jobs?kind=scheduled:<job>. `exact` jobs run once per piece of work at its own time; their row gives `pending` and the next one due.

#### Signature

```http
GET /jobs/scheduled () -> { jobs: [JobRow], options: { intervals } }
```

#### Access

Requires a bearer JWT (`Authorization: Bearer <token>`).

#### Errors

Plus the standard platform errors: `401`, `403`, `429`, `500`.

#### See also

- `PUT /jobs/scheduled/{job}`
- `POST /jobs/scheduled/{job}/run`
- `GET /jobs`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `orgid` | header | string | yes | Organization (tenant) identifier. Every request is scoped to this org; data from other orgs is never visible. Issued with your API credentials. |
| `jobs` | query | string | yes |  |

### Responses

| Status | Meaning |
| --- | --- |
| `200` | { jobs: [JobRow], options: { intervals } } |
| `401` | Authentication failed: Invalid or expired token — The `Authorization` header is missing, malformed, or the JWT has expired. |
| `403` | You do not have permission to perform this action — The caller is authenticated but lacks the role required by the endpoint, or is acting on another org. |
| `429` | Too Many Requests — More than 100,000 requests from one IP within 5 minutes (configurable per deployment). CORS preflights and requests from inside the platform cluster are not counted. The limiter answers before the error filter, so the body is `{ statusCode, error, message }` with no `path`, `method` or `timeStamp`; the `RateLimit-*` response headers say when the window resets. |
| `500` | An unexpected error occurred. Our team has been notified. — An unhandled server-side failure. |

Example response:

```json
{
  "jobs": [
    {
      "job": "readiness-daily",
      "group": "readiness",
      "label": "Readiness daily run",
      "kind": "daily",
      "enabled": true,
      "available": true,
      "inUse": true,
      "time": "04:00",
      "timezone": "America/Los_Angeles",
      "timezoneSetting": "",
      "schedule": "Daily at 04:00 (America/Los_Angeles)",
      "cron": "0 4 * * *",
      "scheduleId": "68f0c2a1e4b0a1b2c3d4e5f6",
      "queued": true,
      "nextRun": "2026-10-04T11:00:00.000Z",
      "lastRun": {
        "at": "2026-10-03T11:00:00.120Z",
        "trigger": "schedule",
        "ok": true,
        "ms": 5310,
        "summary": {
          "assigned": 3
        },
        "jobId": "68f0c2a1e4b0a1b2c3d4e5f7"
      }
    }
  ],
  "options": {
    "intervals": [
      {
        "value": 10,
        "label": "Every 10 minutes"
      }
    ]
  }
}
```

