---
title: "Count jobs based on status"
method: GET
path: "/jobs/count"
---

# Count jobs based on status

`GET /jobs/count`

## Request

- Base URL: `/scheduler` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/scheduler/jobs/count`
- Auth: one of:
  - API key in header `Authorization`
  - API key in query parameter `token`

## Query parameters

- `status` 'CREATED' | 'QUEUED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED' | 'STOPPING' | 'STOPPED'

## Response `200`

Successfully counted jobs.

- object
  - `count` integer

## Other responses

- `500`: Server error

---

[API](https://skmtc.dev/jupyter-server/apis/jupyter-scheduler-api.md) - [All operations](https://skmtc.dev/jupyter-server/apis/jupyter-scheduler-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jupyter-server/apis/jupyter-scheduler-api/revisions/f49a837fc1f2?raw)