List certificates

get

https://{hostname}/mtls-edge-truststore/v2/ca-sets/{caSetId}/versions/{version}/certificates

List certificates for the specified version.

Path Params

caSetId

string

required

Identifies each CA set.

version

integer

required

CA set version number that filters out the activations or deactivations.

Query Params

certificateStatus

string

enum

Enum Status of the certificate to filter the certificates. Accepted values are EXPIRED, EXPIRING, or ACTIVE. The status ACTIVE shouldn't be combined with EXPIRING.

Allowed:

expiryThresholdInDays

integer

Specifies the threshold in days to filter certificates based on their expiration date. Default value is 30. A positive value (e.g., 10) includes certificates expiring in the next 10 days, while the same value also includes certificates that expired in the past 10 days depending on certificateStatus query parameter.

expiryThresholdTimestamp

date-time

Specifies the threshold in timestamp to filter certificates based on their expiration date and time.

accountSwitchKey

string

For customers who manage more than one account, this runs the operation from another account. The Identity and Access Management API provides a list of available account switch keys.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

URL

Response

Choose an example:

application/json

application/problem+json

200The response returns all certificates for the specified version.

400Bad request due to bad query param value.

401Unauthorized.

403Forbidden.

404Not found.

405Method not allowed.

415Unsupported media type.

429Too Many Requests.

500Internal server error.

503Service Unavailable.