List Certificates

Retrieves the certificates records.

Request

Request-Line

GET /sfd/v2.0/certs HTTP/1.1

Request Parameters

Response

Response Body

Parameter	Type	Required	Description
	Array	Mandatory	Array of Certificate.

Object: Certificate

Property name	Type	Required	Description
id	Long	Mandatory	Unique identifier of the certificate record.
customerId	Integer	Mandatory	The certificate under customer ID.
commonName	String	Mandatory	Common name.
subjectAlternativeNames	String	Mandatory	Subject alternative names.
serialNumber	String	Mandatory	Serial number.
issuer	String	Mandatory	Issuer.
organization	String	Optional	Organization.
organizationalUnit	String	Optional	Organizational unit.
country	String	Mandatory	Country.
stateOrProvince	String	Optional	State or province.
locality	String	Optional	Locality.
validFrom	String	Mandatory	Validity period start time in UTC.
validTo	String	Mandatory	Validity period end time in UTC.
created	String	Mandatory	Created time in UTC.
expireIn	Integer	Mandatory	Remaining days before the certificate expireds.

Time Format: All timestamps use ISO 8601 format without milliseconds: yyyy-MM-dd'T'HH:mm:ss'Z'. Example: 2025-06-25T08:59:38Z

Status Codes, Error Codes and Error Messages

Status Code	Error Code	Error Message
404	Customer.NotFound	Customer is not found.
403	Customer.DELETED	Customer has been deleted.

Examples

List Certificates

Request

GET /sfd/v2.0/certs HTTP/1.1

Successful Response Body

[
        {
        "id": 2356,
        "customerId": 123,
        "commonName": "*.example.com",
        "subjectAlternativeNames": "DNS:*.example.com, DNS:example.com",
        "serialNumber": "231272262238822062748024707871705586383",
        "issuer": "DigiCert Global G3 TLS ECC SHA384 2020 CA1",
        "organization": "",
        "organizationalUnit": "",
        "country": "CN",
        "stateOrProvince": "",
        "locality": "",
        "validFrom": "2024-06-25T08:59:38Z",
        "validTo": "2025-06-25T08:59:38Z",
        "created": "2024-06-25T13:33:18Z",
        "expireIn": 358
    },
    {
        "id": 2356,
        "customerId": 123,
        "commonName": "*.example.org",
        "subjectAlternativeNames": "DNS:*.example.org, DNS:example.org",
        "serialNumber": "231272262238822062748024707871705586383",
        "issuer": "DigiCert Global G3 TLS ECC SHA384 2020 CA1",
        "organization": "",
        "organizationalUnit": "",
        "country": "CN",
        "stateOrProvince": "",
        "locality": "",
        "validFrom": "2024-06-25T08:59:38Z",
        "validTo": "2025-06-25T08:59:38Z",
        "created": "2024-06-25T13:33:18Z",
        "expireIn": 358
    }
]