.TH SQ 1 1.2.0 "Sequoia PGP" "User Commands"
.SH NAME
sq key approvals list \- Lists third\-party certifications and their approval status
.SH SYNOPSIS
.br
\fBsq key approvals list\fR [\fIOPTIONS\fR]  
.SH DESCRIPTION
Lists third\-party certifications and their approval status.
.PP
To prevent certificate flooding attacks, modern key servers prevent uncontrolled distribution of third\-party certifications on certificates.  To allow the key holder to control what information is distributed with their certificate, these key servers only distribute third\-party certifications that the key holder has explicitly approved.
.PP


.SH OPTIONS
.SS "Subcommand options"
.TP
\fB\-\-cert\fR=\fIFINGERPRINT|KEYID\fR
List the approvals on the certificate with the specified fingerprint or key ID
.TP
\fB\-\-cert\-email\fR=\fIEMAIL\fR
List the approvals on the certificate where a user ID includes the specified email address
.TP
\fB\-\-cert\-file\fR=\fIPATH\fR
List the approvals on the certificate read from PATH
.TP
\fB\-\-cert\-userid\fR=\fIUSERID\fR
List the approvals on the certificate with the specified user ID
.TP
\fB\-\-email\fR=\fIEMAIL\fR
Use the self\-signed user ID with the specified email address
.TP
\fB\-\-pending\fR
List unapproved certifications
.TP
\fB\-\-userid\fR=\fIUSERID\fR
Use the specified self\-signed user ID
.IP
The specified user ID must be self signed.
.SS "Global options"
See \fBsq\fR(1) for a description of the global options.
.SH EXAMPLES
.PP

.PP
Lists the approved certifications on all the user IDs.
.PP
.nf
.RS
sq key approvals list \\
.RE
.RS
.RS
\-\-cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0
.RE
.RE
.PP
.fi

.PP
Lists the unapproved certifications on all the user IDs.
.PP
.nf
.RS
sq key approvals list \-\-pending \\
.RE
.RS
.RS
\-\-cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0
.RE
.RE
.PP
.fi

.PP
Lists all unapproved certifications on a given user ID.
.PP
.nf
.RS
sq key approvals list \-\-pending \-\-email=alice@example.org \\
.RE
.RS
.RS
\-\-cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0
.RE
.RE
.fi
.SH "SEE ALSO"
.nh
\fBsq\fR(1), \fBsq\-key\fR(1), \fBsq\-key\-approvals\fR(1).
.hy
.PP
For the full documentation see <https://book.sequoia\-pgp.org>.
.SH VERSION
1.2.0 (sequoia\-openpgp 1.22.0)