Describe a namespace

For guidance and examples, see Manage namespaces.

Note: This operation is not supported for pod-based indexes.

PINECONE_API_KEY="YOUR_API_KEY"
INDEX_HOST="YOUR_INDEX_HOST"
NAMESPACE="YOUR_NAMESPACE"  # To target the default namespace, use "__default__".

curl "https://$INDEX_HOST/namespaces/$NAMESPACE" \
    -H "Api-Key: $PINECONE_API_KEY" \
    -H "X-Pinecone-Api-Version: 2026-07"

GET /namespaces/{namespace}

• X-Pinecone-Api-Version (header, string, required) — Required date-based version header
• namespace (path, string, required) — The namespace to describe. Must be ASCII, must not contain the NUL character, and must be 1-512 characters long. Use __default__ to describe the namespace that requests address when they omit a namespace.

• 200 — A description of a namespace.
• 400 — Bad request. The request body included invalid request parameters.
• 401 — Unauthorized. Possible causes: missing or invalid API key.
• 404 — Namespace not found. No namespace of the given name exists on the index.
• 429 — Too many requests. This operation is rate limited per index and per namespace. Prefer GET /namespaces when describing more than one namespace: it returns the same information for every namespace in a single request.
• 4XX — An unexpected error response.
• 5XX — An unexpected error response.