Need help? Call Live Support at +31 (0) 38 453 07 59

Get

Used to get information about a certificate

For backwards compatibility this call is also available on the url /v2/customers/customer/certificates/certificateId
  • GETMethod
  • /v2/ssl/certificates/certificateIdURL
URL fields
Name Type Description Restrictions
certificateId Integer The ID of the certificate
Request parameters
Name Type Required / Optional Description Restrictions
fields String Optional Select fields to include in the response, comma separated list of field names. Requesting only the needed fields improves response time, especially when omitting relation fields. Identifying field(s) are always included.

Successful request

Retrieved certificate information successfully
  • 200 OKHTTP Status
  • application/jsonContent-Type
Response fields
Name Type Required / Optional Description
id Integer Required The ID of the certificate
process Integer Required The ID of the request process
product String Required The certificate product
validationType Enum Required The type of validation used for the certificate

Possible values:

  • DOMAIN_VALIDATION: Domain validation
  • ORGANIZATION_VALIDATION: Organization validation
  • EXTENDED_VALIDATION: Extended validation
certificateType Enum Required The type of certificate

Possible values:

  • SINGLE_DOMAIN: Single domain
  • MULTI_DOMAIN: Multi domain
  • WILDCARD: Wildcard
domainName String Required The domain name
organization String Optional The organization used with the certificate
department String Optional The department used with the certificate
addressLine List <String> Optional The address lines used with the certificate
city String Optional The city used with the certificate
state String Optional The state used with the certificate
postalCode String Optional The postal code used with the certificate
country String Optional The country code used with the certificate
coc String Optional Chamber Of Commerce identifier, see requiredFields/optionalFields in ssl product metadata for usage
providerId String Optional The certificate ID of the provider
startDate Timestamp Required The start date of the certificate
expiryDate Timestamp Required The expiry date of the certificate
subscriptionEndDate Timestamp Optional For subscription based certificates, the end date of the subscription
san List <String> Optional List of SAN domains
status Enum Required The status of the certificate

Possible values:

  • ACTIVE: Active
  • EXPIRED: Expired
  • REVOKED: Revoked
  • REISSUED: Reissued
  • RENEWED: Renewed
publicKeyAlgorithm Enum Optional The algorithm used for the public key

Possible values:

  • RSA
  • ECDSA
publicKeySize Integer Optional The key size in bits of the public key
csr String Optional The Certificate Signing Request
certificate String Optional The Certificate
fingerprint String Optional The SHA-256 fingerprint of the certificate

Failed requests

Generic errors can be expected.

URL fields
The ID of the certificate
Request parameters
Select fields to include in the response, comma separated list of field names. Requesting only the needed fields improves response time, especially when omitting relation fields. Identifying field(s) are always included.
Request

GET /v2/ssl/certificates/certificateId

Response