Skip to main content Link Menu Expand (external link) Document Search Copy Copied
Auth0 CLI

auth0 client-grants list

List your existing client grants. To create one, run: auth0 client-grants create.

Use the filter flags to narrow the results server-side by client, audience, subject type, default group or organization usage.

Use ‘–schema’ to see available query parameters. Use ‘–query’ to filter results via a JSON object (any API-supported parameter works immediately).

Usage 

auth0 client-grants list [flags]

Examples 

  auth0 client-grants list
  auth0 client-grants ls
  auth0 client-grants ls --number 100
  auth0 client-grants ls --audience <api-identifier>
  auth0 client-grants ls --client-id <client-id> --subject-type client
  auth0 client-grants ls --default-for third_party_clients
  auth0 client-grants ls --allow-any-organization=true
  auth0 client-grants ls -n 100 --json
  auth0 client-grants ls --csv
  auth0 client-grants list --schema
  auth0 client-grants list --schema --json
  auth0 client-grants list --query '{"audience":"https://example.com/api"}'
  auth0 client-grants list --query '{"client_id":"<client-id>","per_page":50}' --json

Flags 

      --allow-any-organization   Filter by whether any organization can be used with the grant (true) or only explicitly assigned organizations (false).
  -a, --audience string          Filter by audience (API identifier).
  -c, --client-id string         Filter by client ID. Mutually exclusive with --default-for.
      --csv                      Output in csv format.
      --default-for string       Filter by the group this grant is the default for. Possible value: third_party_clients. Mutually exclusive with --client-id.
      --json                     Output in json format.
      --json-compact             Output in compact json format.
  -n, --number int               Number of client grants to retrieve. Minimum 1, maximum 1000. (default 100)
  -q, --query string             Filter results with a JSON object of query parameters. Any API-supported parameter works immediately. Run '--schema' to see documented parameters. On offset-paginated endpoints, add "include_totals":true to receive total counts and a pagination hint (without it the API returns a bare array and no hint can be given).
      --schema                   Print the request payload schema for this command and exit. Use with --json or --json-compact for machine-readable output.
      --subject-type string      Filter by subject type. Possible values: client, user, anonymous_user.

Inherited Flags 

      --agent-mode      Output JSON, disable prompts and colors. Auto-enabled for AI agents; set AUTH0_AGENT_MODE=false to disable.
      --debug           Enable debug mode.
      --no-color        Disable colors.
      --no-input        Disable interactivity.
      --tenant string   Specific tenant to use.