---
title: "List namespaces"
method: GET
path: "/namespaces"
tags: ["Namespace Operations"]
---

# List namespaces

`GET /namespaces`

List all namespaces in a serverless index.

Up to 100 namespaces are returned at a time by default, in sorted order (bitwise “C” collation). If the `limit` parameter is set, up to that number of namespaces are returned instead. Whenever there are additional namespaces to return, the response also includes a `pagination_token` that you can use to get the next batch of namespaces. When the response does not include a `pagination_token`, there are no more namespaces to return.

For guidance and examples, see [Manage namespaces](https://docs.pinecone.io/guides/manage-data/manage-namespaces).

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

## Query parameters

- `limit` integer
- `paginationToken` string
- `prefix` string

## Headers

- `X-Pinecone-Api-Version` string, required

## Response `200`

A successful response

- DbDataListNamespacesResponse
  - `namespaces` DbDataNamespaceDescription[] — The list of namespaces belonging to this index.
    - `name` string — The name of the namespace.
    - `record_count` integer — The total amount of records within the namespace.
    - `schema` object — Schema for the behavior of Pinecone's internal metadata index. By default, all metadata is indexed; when `schema` is present, only fields which are present in the `fields` object with a `filterable: true` are indexed. Note that `filterable: false` is not currently supported.
      - `fields` object, required — A map of metadata field names to their configuration. The field name must be a valid metadata field name. The field name must be unique.
    - `indexed_fields` object — A list of all indexed metatadata fields in the namespace
      - `fields` string[]
  - `pagination` DbDataPagination
    - `next` string
  - `total_count` integer — The total number of namespaces in the index matching the prefix

## Other responses

- `4XX` — An unexpected error response.
- `5XX` — An unexpected error response.

---

[API](https://skmtc.net/pinecone/apis/pinecone-api.md) · [All operations](https://skmtc.net/pinecone/apis/pinecone-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pinecone/pinecone-api/revisions/35876583485d/schema)