---
title: "GET /nodecounts"
method: GET
path: "/nodecounts"
tags: ["Accounts"]
---

# GET /nodecounts

`GET /nodecounts`

Gets the number of nodes in each state, grouped by pool.

## Query parameters

- `$filter` string
- `maxresults` integer
- `timeout` integer
- `api-version` string, required

## Headers

- `client-request-id` string, uuid
- `return-client-request-id` boolean
- `ocp-date` string, date-time-rfc1123

## Response `200`

The response contains the number of nodes in each node state, grouped by pool.

- PoolNodeCountsListResult
  - `odata.nextLink` string
  - `value` PoolNodeCounts[] — A list of node counts by pool.
    - `dedicated` NodeCounts
      - `creating` integer, required
      - `idle` integer, required
      - `leavingPool` integer, required
      - `offline` integer, required
      - `preempted` integer, required
      - `rebooting` integer, required
      - `reimaging` integer, required
      - `running` integer, required
      - `startTaskFailed` integer, required
      - `starting` integer, required
      - `total` integer, required
      - `unknown` integer, required
      - `unusable` integer, required
      - `waitingForStartTask` integer, required
    - `lowPriority` NodeCounts
      - `creating` integer, required
      - `idle` integer, required
      - `leavingPool` integer, required
      - `offline` integer, required
      - `preempted` integer, required
      - `rebooting` integer, required
      - `reimaging` integer, required
      - `running` integer, required
      - `startTaskFailed` integer, required
      - `starting` integer, required
      - `total` integer, required
      - `unknown` integer, required
      - `unusable` integer, required
      - `waitingForStartTask` integer, required
    - `poolId` string, required

## Other responses

- `default` — The error from the Batch service.

---

[API](https://skmtc.net/windows/apis/batch-batchservice.md) · [All operations](https://skmtc.net/windows/apis/batch-batchservice/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/windows/batch-batchservice/revisions/9ab62bb93c5f/schema)