Skip to main content
Pinecone Docs

Search documentation

Type to search this documentation.

List users in the organization

List users in the caller's organization, optionally filtered by email address.

JavaScript
// Requires Node.js SDK v8.2.0 or later
import { AdminClient } from '@pinecone-database/pinecone';

// Reads PINECONE_CLIENT_ID and PINECONE_CLIENT_SECRET from the environment
const admin = new AdminClient();

const { data: users } = await admin.users.list();
console.log(users);
Go
// Requires Go SDK v6.0.0 or later
package main

import (
    "context"
    "fmt"
    "log"
    "os"

    "github.com/pinecone-io/go-pinecone/v6/pinecone"
)

func main() {
    ctx := context.Background()

    adminClient, err := pinecone.NewAdminClientWithContext(ctx, pinecone.NewAdminClientParams{
        ClientId:     os.Getenv("PINECONE_CLIENT_ID"),
        ClientSecret: os.Getenv("PINECONE_CLIENT_SECRET"),
    })
    if err != nil {
        log.Fatalf("Failed to create AdminClient: %v", err)
    }

    users, err := adminClient.User.List(ctx, &pinecone.ListUsersParams{})
    if err != nil {
        log.Fatalf("Failed to list users: %v", err)
    }
    for _, user := range users.Data {
        fmt.Printf("User: %v (%v)\n", user.Email, user.Id)
    }
}
Terraform
# Requires Terraform provider v4.0.0 or later
data "pinecone_users" "all" {}

output "user_emails" {
  value = [for user in data.pinecone_users.all.users : user.email]
}
curl
PINECONE_ACCESS_TOKEN="YOUR_ACCESS_TOKEN"

curl -X GET "https://api.pinecone.io/admin/users" \
	-H "Authorization: Bearer $PINECONE_ACCESS_TOKEN" \
	-H "accept: application/json" \
	-H "X-Pinecone-Api-Version: 2026-04"
curl
{
  "data": [
    {
      "id": "e2e92523-85dc-4142-b8c2-e681be8b78df",
      "email": "alice@example.com",
      "name": "Alice Example",
      "created_at": "2026-04-10T15:23:00Z",
      "updated_at": "2026-04-12T09:11:00Z"
    }
  ],
  "pagination": {
    "next": "eyJsYXN0X2lkIjoiZTJlOTI1MjMifQ=="
  }
}
GET/admin/users

List users in the organization

4 parameters
  • X-Pinecone-Api-Versionstringheaderrequired

    Required date-based version header

  • emailstringquery

    Case-insensitive filter on the user's email address. Malformed email returns `400 INVALID_ARGUMENT`.

  • limitintegerquery

    The number of results to return per page. When omitted, the server defaults to 100. Out-of-range values return `400 OUT_OF_RANGE`.

  • paginationTokenstringquery

    Cursor from `pagination.next` of a prior response. Must be reused with the same query context (path parameters, filters, and `limit`).

Suggest an edit

Propose a replacement for this page. The site team reviews it before applying any changes.

Export
Documentation menu