---
title: "Get Schedule Count"
method: GET
path: "/schedules/{schedule_id}/count"
---

# Get Schedule Count

`GET /schedules/{schedule_id}/count`

Report the retained schedule count and completion state for one session.

Args:
    schedule_id: Unique identifier of the session to inspect.

Returns:
    Current result count, requested limit, and whether enumeration is complete.

Raises:
    HTTPException: Status 404 when the session does not exist.

Behavior:
    This is a non-blocking snapshot: it neither awaits initialization nor
    acquires the generation lock. Completion is true after solver exhaustion or
    once the retained count reaches the requested limit. Access refreshes TTL.

## Path parameters

- `schedule_id` string, required

## Response `200`

Successful Response

- ScheduleCountResponse — Response model for schedule count requests. **Usage:** ```python ScheduleCountResponse(schedule_id='...', current_count=2, limit=10, is_complete=False) ``` **Fields:** - schedule_id: Unique identifier for the schedule session - current_count: Number of schedules currently generated - limit: Maximum number of schedules to generate - is_complete: Whether all schedules have been generated
  - `schedule_id` string, required
  - `current_count` integer, required
  - `limit` integer, required
  - `is_complete` boolean, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mucsci/apis/course-scheduler-api.md) · [All operations](https://skmtc.net/mucsci/apis/course-scheduler-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mucsci/course-scheduler-api/revisions/f728bfcee693/schema)