verdict fact list

Source command definition

Read one page of directly stored facts without evaluating policy rules.

Runs against the selected server connection. Effects: read stored facts.

Arguments and flags

Argument	Type	Required	Default	Description
--predicate	string	no	No parser default	Filter by predicate name
--query	string	no	No parser default	Textual predicate filter; cannot be combined with —predicate
--limit	string	no	No parser default	Results per page (default: 100, max: 1000)
--cursor	string	no	No parser default	Pagination cursor from a previous response
--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

Flags only; pagination reads one page.

File input: unsupported. Standard input: unsupported.

• query and predicate are mutually exclusive
• limit must contain decimal digits representing an integer from 1 through 1000

Result

{
  "kind": "protobuf",
  "reference": "verdict-client/proto:ListFactsResponse",
  "projection": "JSON object containing facts and an optional nextCursor",
  "encoding": "Default-valued fields are omitted; 64-bit integers are decimal strings",
  "example": {}
}

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 fact list --predicate role --json
verdict fact list --limit 5 --cursor previous