verdict query

Source command definition

Query stored facts and predicates derived from policy rules, returning values for wildcards. Use fact list to retrieve only stored facts.

Runs against the selected server connection. Effects: read server state.

Arguments and flags

Argument	Type	Required	Default	Description
<predicate>	positional	yes	No parser default	Predicate name or literal, for stored facts or derived predicates
--json	boolean	no	false	Output as JSON
--endpoint	string	no	No parser default	Instance base URL, including any subpath (env: VERDICT_HOST, fallback: http://localhost:4891)
--host	string	no	No parser default	Alias for —endpoint
--api-key	string	no	No parser default	API key (env: VERDICT_API_KEY takes precedence)
--profile	string	no	No parser default	Stored profile (env: VERDICT_PROFILE)
--local	boolean	no	false	Use http://localhost:4891 without stored or environment credentials

--help (-h) shows command help without executing the command. Boolean flags support --no-<flag>. Defaults stated in descriptions may be resolved by the handler or configuration rather than the argument parser.

Input

A predicate literal or a predicate name followed by separate terms.

File input: unsupported. Standard input: unsupported. The predicate positional accepts additional terms or paths.

Result

{
  "kind": "protobuf",
  "reference": "verdict.v1.QueryResponse",
  "projection": "Rows of wildcard values in position order; empty results omit rows.",
  "encoding": "ProtoJSON; int64 constants are decimal strings."
}

By default, the command renders human-readable records. --json writes one JSON result to stdout. Operational failures use status 1; JSON failures contain an error object with code and message. See shared output semantics.

Exit status

• 0: the command completed its operation.

Argument, I/O, and other failures handled by the CLI runner use status 1.

Examples

verdict query 'role(User:alice, _)' --json