---
name: "hypothesis-client-groups-list"
section: "1"
platform: "linux"
package: "hypothesis-client"
version: "0.12.0-3+b1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/hypothesis-client-groups-list"
---

# hypothesis-client-groups-list(1)

Retrieve a list of applicable Groups, filtered by authority and target document (document\_uri). Also retrieve user's private Groups

## NAME

hypothesis-client groups list - Retrieve a list of applicable Groups, filtered by authority and target document (document\_uri). Also retrieve user's private Groups

## SYNOPSIS

**hypothesis-client** *groups list* \[*OPTIONS*\]

## DESCRIPTION

Retrieve a list of applicable Groups, filtered by authority and target document (document\_uri). Also retrieve user's private Groups

## OPTIONS

**--authority** \<AUTHORITY\>

-

  Filter returned groups to this authority. For authenticated requests, the user's associated authority will supersede any provided value.

-

  Default: "hypothes.is"

-

  \[default: hypothes.is\]

**--document-uri** \<DOCUMENT\_URI\>

-

  Only retrieve public (i.e. non-private) groups that apply to a given document URI (i.e. the target document being annotated)

-

  \[default: \]

**--expand** \<EXPAND\>

-

  One or more relations to expand for a group resource. Possible values: organization, scopes

-

  Possible values: - organization: Expand \`organization\` field to \`Org\` - scopes:       Expand \`scopes\` field to \`Scope\`

**-o**, **--file** \<FILE\>

-

  json file to write filtered groups to, writes to stdout if not given

**-h**, **--help**

-

  Print help (see a summary with '-h')