Get Namespace Stats

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

GET /v1/namespaces/{namespace_identifier}/stats

Get Namespace Stats

cURL

curl --request GET \
  --url https://api.mixpeek.com/v1/namespaces/{namespace_identifier}/stats \
  --header 'Authorization: Bearer <token>'

200

{
  "namespace_id": "<string>",
  "document_count": 0,
  "bucket_count": 0,
  "collection_count": 0,
  "object_count": 0
}

Authorizations

Authorization · string · header · required

Mixpeek API key, sent as Authorization: Bearer mxp_sk_.... Create one in Studio under Settings → API Keys, or with an admin key via POST /v1/organizations/users/{user_email}/api-keys. A missing header returns 403; an invalid or revoked key returns 401.

Path Parameters

namespace_identifier · string · required

Either the namespace name or namespace ID

Examples:

"my_namespace"

"ns_1234567890"

Response

200

application/json

Successful Response

Per-namespace statistics (counts) returned by the stats endpoint.

namespace_id · string · required

Namespace identifier

document_count · integer · default: 0

Total number of documents in this namespace

bucket_count · integer · default: 0

Total number of buckets in this namespace

collection_count · integer · default: 0

Total number of collections in this namespace

object_count · integer · default: 0

Total number of objects across all buckets in this namespace