---
title: "Count endpoints per state [READ]"
method: GET
path: "/v2/search/{namespace}/states"
tags: ["Endpoints"]
---

# Count endpoints per state \[READ\]

`GET /v2/search/{namespace}/states`

## Request

- Base URL: `https://api.endpoints.huggingface.cloud` (the document declares no server; this is the origin it was published from)
- URL: `https://api.endpoints.huggingface.cloud/v2/search/{namespace}/states`
- Auth: HTTP bearer

Buckets are the states accepted by the `state` filter of `GET /v2/endpoint/{namespace}`.

## Path parameters

- `namespace` string, required

## Response `200`

Endpoints counted successfully

- EndpointStateCounts: Number of endpoints in each state accepted by the `state` list filter
  - `failed` integer, required
  - `paused` integer, required
  - `running` integer, required
  - `scaledToZero` integer, required
  - `updating` integer, required

## Changes

- **2026-10-22** `029d3baf0ca3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/huggingface/apis/hf-inference-endpoints-api/changes/v2/search/:namespace/states/get.md)

---

[API](https://skmtc.dev/huggingface/apis/hf-inference-endpoints-api.md) - [All operations](https://skmtc.dev/huggingface/apis/hf-inference-endpoints-api/llms.txt) - [OpenAPI document](https://skmtc.dev/huggingface/apis/hf-inference-endpoints-api/revisions/029d3baf0ca3?raw)