Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-14159984.9 KB

Retrieves a list of certificate ARNs and domain names. You can request that only certificates that match a specific status be listed. You can also filter by specific attributes of the certificate. Default filtering returns only <code>RSA_2048</code> certificates. For more information, see <a>Filters</a>.

post/#X-Amz-Target=CertificateManager.ListCertificates

Query parameters

MaxItemsstring

Pagination limit

NextTokenstring

Pagination token

Headers

X-Amz-Target'CertificateManager.ListCertificates' required

Request body

CertificateStatusesCertificateStatus[]

Filter the certificate list by status value.

NextTokenstring

Use this parameter only when paginating results and only in a subsequent request after you receive a response with truncated results. Set it to the value of <code>NextToken</code> from the response you just received.

MaxItemsinteger

Use this parameter when paginating results to specify the maximum number of items to return in the response. If additional items exist beyond the number you specify, the <code>NextToken</code> element is sent in the response. Use this <code>NextToken</code> value in a subsequent request to retrieve additional items.

SortBy'CREATED_AT'

Specifies the field to sort results by. If you specify <code>SortBy</code>, you must also specify <code>SortOrder</code>.

SortOrder'ASCENDING' | 'DESCENDING'

Specifies the order of sorted results. If you specify <code>SortOrder</code>, you must also specify <code>SortBy</code>.

Response

Success

NextTokenstring

When the list is truncated, this value is present and contains the value to use for the <code>NextToken</code> parameter in a subsequent pagination request.