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

# スケジュールを一覧表示する

> Identity の Forward スケジュールをカーソルページネーションで一覧表示します。

`GET /api/v1/forward/schedules`

Schedule 設定レコードを返します。アーカイブ済みのスケジュールはデフォルトで除外されます。

## Headers

| Header          | Required | Description    |
| --------------- | -------- | -------------- |
| `Authorization` | Yes      | `Bearer <PAT>` |

## Query parameters

| Parameter          | Type    | Required | Default                             | Description                        |
| ------------------ | ------- | -------- | ----------------------------------- | ---------------------------------- |
| `identity_id`      | string  | Yes      | Schedule を所有する Forward Identity ID。 |                                    |
| `template_id`      | string  | No       | -                                   | Forward Template ID でフィルタリングします。   |
| `status`           | string  | No       | -                                   | `active` または `paused` でフィルタリングします。 |
| `include_archived` | boolean | No       | `false`                             | アーカイブ済みのスケジュールを含めます。               |
| `limit`            | integer | No       | 20                                  | 1 ページあたりの項目数。最大 100。               |
| `after_id`         | string  | No       | -                                   | 指定した Schedule ID より後のレコードのカーソル。    |
| `before_id`        | string  | No       | -                                   | 指定した Schedule ID より前のレコードのカーソル。    |

## Example request

```bash theme={null}
curl -s -X GET 'https://api.qoder.com/api/v1/forward/schedules?identity_id=idn_019eabc123&limit=20' \
  -H "Authorization: Bearer $QODER_PAT"
```

## Example response

**HTTP 200 OK**

```json theme={null}
{
  "data": [
    {
      "id": "sched_019f00112233445566778899aabbccdd",
      "identity_id": "idn_019eabc123",
      "template_id": "tmpl_support",
      "name": "Daily tech brief",
      "description": "Generate a daily technology news summary",
      "status": "active",
      "paused_reason": null,
      "initial_events": [
        {
          "type": "user.message",
          "content": "Summarize current technology news in five bullet points."
        }
      ],
      "execution": {
        "session_mode": "new_session",
        "max_concurrent_runs": 1,
        "max_attempts": 1,
        "timeout_ms": 300000
      },
      "trigger_policy": {
        "type": "cron",
        "expression": "0 9 * * *",
        "timezone": "Asia/Shanghai",
        "upcoming_runs_at": ["2026-06-23T01:00:00Z"]
      },
      "environment_id": "env_019e64e01a137caf953ac2ac7b42ec5c",
      "sinks": [],
      "metadata": {},
      "archived_at": null,
      "created_at": "2026-06-22T10:00:00Z",
      "updated_at": "2026-06-22T10:00:00Z"
    }
  ],
  "first_id": "sched_019f00112233445566778899aabbccdd",
  "last_id": "sched_019f00112233445566778899aabbccdd",
  "has_more": false
}
```

## Response fields

| Field      | Type         | Description                 |
| ---------- | ------------ | --------------------------- |
| `data`     | array        | 現在のページの完全な Schedule オブジェクト。 |
| `first_id` | string\|null | このページの最初のレコードの ID。          |
| `last_id`  | string\|null | このページの最後のレコードの ID。          |
| `has_more` | boolean      | さらにレコードが残っているかどうか。          |

## Errors

| HTTP | Type                    | Code                      | Trigger                     |
| ---- | ----------------------- | ------------------------- | --------------------------- |
| 400  | `invalid_request_error` | `invalid_identity`        | `identity_id` が欠落しているか無効です。 |
| 400  | `invalid_request_error` | `invalid_pagination`      | ページネーションパラメータが無効です。         |
| 401  | `authentication_error`  | `authentication_required` | PAT が無効または期限切れです。           |

## Notes

* 結果は作成日時の降順で返されます。
* アーカイブ済みのレコードは `include_archived=true` の場合のみ返されます。

## Related

<CardGroup cols={2}>
  <Card title="スケジュールを作成する" icon="plus" href="/cloud-agents/api/forward/schedules/create" />

  <Card title="スケジュール実行を一覧表示する" icon="history" href="/cloud-agents/api/forward/schedule-runs/list" />
</CardGroup>