---
title: "Get Namespace Stats"
method: GET
path: "/v1/namespaces/{namespace_identifier}/stats"
tags: ["Namespaces"]
---

# Get Namespace Stats

`GET /v1/namespaces/{namespace_identifier}/stats`

Returns document, bucket, collection, and object counts for a single namespace. Use this instead of relying on counts in the list endpoint.

## Path parameters

- `namespace_identifier` string, required — Either the namespace name or namespace ID

## Response `200`

Successful Response

- NamespaceStatsResponse — Per-namespace statistics (counts) returned by the stats endpoint.
  - `namespace_id` string, required — Namespace identifier
  - `document_count` integer — Total number of documents in this namespace
  - `bucket_count` integer — Total number of buckets in this namespace
  - `collection_count` integer — Total number of collections in this namespace
  - `object_count` integer — Total number of objects across all buckets in this namespace

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/mixpeek/apis/mixpeek-api.md) · [All operations](https://skmtc.net/mixpeek/apis/mixpeek-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mixpeek/mixpeek-api/versions/220a3b263fda/schema)