---
name: "sq-keyring-list"
section: "1"
platform: "linux"
package: "sequoia-sq"
version: "1.4.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/sq-keyring-list"
---

# sq-keyring-list(1)

List keys in a keyring

## NAME

sq-keyring-list - List keys in a keyring

## SYNOPSIS

**sq keyring list** \[*OPTIONS*\] *FILE*

## DESCRIPTION

List keys in a keyring.

Prints the fingerprint as well as the primary userid for every certificate encountered in the keyring.

## OPTIONS

### Subcommand options

- **--all-userids**

  List all user IDs

-

  Include user IDs that are expired, revoked, or not valid under the standard policy.

- *FILE*

  Read from FILE or stdin if FILE is '-'

-

  \[default: **-**\]

### Global options

See [**sq**(1)](/sq/1.md) for a description of the global options.

## EXAMPLES

List all certificates.

```
sq keyring list certs.pgp
```

List all certificates with a user ID on example.org.

```
sq keyring filter --experimental --domain=example.org \
certs.pgp \
| sq keyring list
```

## SEE ALSO

[**sq**(1)](/sq/1.md), [**sq-keyring**(1)](/sq-keyring/1.md).

For the full documentation see \<https://book.sequoia-pgp.org/\>.

## VERSION

1\.4.1