BETTER-AUTH. UI
Queries

useListOrganizationMembers

List members for an organization.

Organization queries require organizationClient() on your Better Auth client. Queries that depend on a signed-in user wait for session data before calling Better Auth.

Usage

import { useAuth, useListOrganizationMembers } from "@better-auth-ui/react"

const { authClient } = useAuth()
const result = useListOrganizationMembers(authClient)

Client options factory and router-loader helpers

import {
  ensureListOrganizationMembers,
  fetchListOrganizationMembers,
  listOrganizationMembersOptions,
  prefetchListOrganizationMembers
} from "@better-auth-ui/react"

const options = listOrganizationMembersOptions(authClient, userId)
await ensureListOrganizationMembers(queryClient, authClient, userId)
await prefetchListOrganizationMembers(queryClient, authClient, userId)
const members = await fetchListOrganizationMembers(queryClient, authClient, userId)

Notes

  • useActiveOrganization treats slug: undefined as the session active organization, a string slug as a URL-selected organization, and slug: null as intentionally no active organization.
  • Member, invitation, and permission helpers follow upstream active-organization fallback behavior when an organization id is not provided.
  • useHasPermission preserves Better Auth's flat permission parameter shape.

Server-side prefetching

For server loaders, import from @better-auth-ui/react/server. Pass the Better Auth server instance, signed-in userId, and the request params for the organization member list.

import { ensureListOrganizationMembers } from "@better-auth-ui/react/server"
import { getRequestHeaders } from "@tanstack/react-start/server"

import { auth } from "@/lib/auth"

await ensureListOrganizationMembers(queryClient, auth, userId, {
  headers: getRequestHeaders(),
  query: { organizationId: "org_123" }
})

Params

Prop

Type

Last updated on

On this page