{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/amazon-lightsail/json-schema/amazon-lightsail-get-certificates-result-schema.json",
  "title": "GetCertificatesResult",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/amazon-lightsail-certificates-api-openapi.yml#/components/schemas/GetCertificatesResult",
  "type": "object",
  "properties": {
    "certificates": {
      "allOf": [
        {
          "$ref": "#/$defs/CertificateSummaryList"
        }
      ],
      "description": "An object that describes certificates."
    },
    "nextPageToken": {
      "allOf": [
        {
          "$ref": "#/$defs/string"
        }
      ],
      "description": "If NextPageToken is returned there are more results available. The value of NextPageToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged."
    }
  },
  "$defs": {
    "Certificate": {
      "type": "object",
      "properties": {
        "arn": {
          "allOf": [
            {
              "$ref": "#/$defs/NonEmptyString"
            }
          ],
          "description": "The Amazon Resource Name (ARN) of the certificate."
        },
        "name": {
          "allOf": [
            {
              "$ref": "#/$defs/CertificateName"
            }
          ],
          "description": "The name of the certificate ( my-certificate )."
        },
        "domainName": {
          "allOf": [
            {
              "$ref": "#/$defs/DomainName"
            }
          ],
          "description": "The domain name of the certificate."
        },
        "status": {
          "allOf": [
            {
              "$ref": "#/$defs/CertificateStatus"
            }
          ],
          "description": "The validation status of the certificate."
        },
        "serialNumber": {
          "allOf": [
            {
              "$ref": "#/$defs/SerialNumber"
            }
          ],
          "description": "The serial number of the certificate."
        },
        "subjectAlternativeNames": {
          "allOf": [
            {
              "$ref": "#/$defs/SubjectAlternativeNameList"
            }
          ],
          "description": "An array of strings that specify the alternate domains ( example2.com ) and subdomains ( blog.example.com ) of the certificate."
        },
        "domainValidationRecords": {
          "allOf": [
            {
              "$ref": "#/$defs/DomainValidationRecordList"
            }
          ],
          "description": "An array of objects that describe the domain validation records of the certificate."
        },
        "requestFailureReason": {
          "allOf": [
            {
              "$ref": "#/$defs/RequestFailureReason"
            }
          ],
          "description": "The validation failure reason, if any, of the certificate. The following failure reasons are possible: NO_AVAILABLE_CONTACTS - This failure applies to email validation, which is not available for Lightsail certificates. ADDITIONAL_VERIFICATION_REQUIRED - Lightsail requires additional information to process this certificate request. This can happen as a fraud-protection measure, such as when the domain ranks within the Alexa top 1000 websites. To provide the required information, use the Amazon Web Services Support Center to contact Amazon Web Services Support. You cannot request a certificate for Amazon-owned domain names such as those ending in amazonaws.com, cloudfront.net, or elasticbeanstalk.com. DOMAIN_NOT_ALLOWED - One or more of the domain names in the certificate request was reported as an unsafe domain by VirusTotal . To correct the problem, search for your domain name on the VirusTotal website. If your domain is reported as suspicious, see Google Help for Hacked Websites to learn what you can do. If you believe that the result is a false positive, notify the organization that is reporting the domain. VirusTotal is an aggregate of several antivirus and URL scanners and cannot remove your domain from a block list itself. After you correct the problem and the VirusTotal registry has been updated, request a new certificate. If you see this error and your domain is not included in the VirusTotal list, visit the Amazon Web Services Support Center and create a case. INVALID_PUBLIC_DOMAIN - One or more of the domain names in the certificate request is not valid. Typically, this is because a domain name in the request is not a valid top-level domain. Try to request a certificate again, correcting any spelling errors or typos that were in the failed request, and ensure that all domain names in the request are for valid top-level domains. For example, you cannot request a certificate for example.invalidpublicdomain because invalidpublicdomain is not a valid top-level domain. OTHER - Typically, this failure occurs when there is a typographical error in one or more of the domain names in the certificate request. Try to request a certificate again, correcting any spelling errors or typos that were in the failed request."
        },
        "inUseResourceCount": {
          "allOf": [
            {
              "$ref": "#/$defs/InUseResourceCount"
            }
          ],
          "description": "The number of Lightsail resources that the certificate is attached to."
        },
        "keyAlgorithm": {
          "allOf": [
            {
              "$ref": "#/$defs/KeyAlgorithm"
            }
          ],
          "description": "The algorithm used to generate the key pair (the public and private key) of the certificate."
        },
        "createdAt": {
          "allOf": [
            {
              "$ref": "#/$defs/IsoDate"
            }
          ],
          "description": "The timestamp when the certificate was created."
        },
        "issuedAt": {
          "allOf": [
            {
              "$ref": "#/$defs/IsoDate"
            }
          ],
          "description": "The timestamp when the certificate was issued."
        },
        "issuerCA": {
          "allOf": [
            {
              "$ref": "#/$defs/IssuerCA"
            }
          ],
          "description": "The certificate authority that issued the certificate."
        },
        "notBefore": {
          "allOf": [
            {
              "$ref": "#/$defs/IsoDate"
            }
          ],
          "description": "The timestamp when the certificate is first valid."
        },
        "notAfter": {
          "allOf": [
            {
              "$ref": "#/$defs/IsoDate"
            }
          ],
          "description": "The timestamp when the certificate expires."
        },
        "eligibleToRenew": {
          "allOf": [
            {
              "$ref": "#/$defs/EligibleToRenew"
            }
          ],
          "description": "The renewal eligibility of the certificate."
        },
        "renewalSummary": {
          "allOf": [
            {
              "$ref": "#/$defs/RenewalSummary"
            }
          ],
          "description": "An object that describes the status of the certificate renewal managed by Lightsail."
        },
        "revokedAt": {
          "allOf": [
            {
              "$ref": "#/$defs/IsoDate"
            }
          ],
          "description": "The timestamp when the certificate was revoked. This value is present only when the certificate status is REVOKED ."
        },
        "revocationReason": {
          "allOf": [
            {
              "$ref": "#/$defs/RevocationReason"
            }
          ],
          "description": "The reason the certificate was revoked. This value is present only when the certificate status is REVOKED ."
        },
        "tags": {
          "allOf": [
            {
              "$ref": "#/$defs/TagList"
            }
          ],
          "description": "The tag keys and optional values for the resource. For more information about tags in Lightsail, see the Amazon Lightsail Developer Guide ."
        },
        "supportCode": {
          "allOf": [
            {
              "$ref": "#/$defs/string"
            }
          ],
          "description": "The support code. Include this code in your email to support when you have questions about your Lightsail certificate. This code enables our support team to look up your Lightsail information more easily."
        }
      },
      "description": "Describes the full details of an Amazon Lightsail SSL/TLS certificate. To get a summary of a certificate, use the GetCertificates action and omit includeCertificateDetails from your request. The response will include only the certificate Amazon Resource Name (ARN), certificate name, domain name, and tags."
    },
    "CertificateDomainValidationStatus": {
      "type": "string",
      "enum": [
        "PENDING_VALIDATION",
        "FAILED",
        "SUCCESS"
      ]
    },
    "CertificateName": {
      "type": "string"
    },
    "CertificateStatus": {
      "type": "string",
      "enum": [
        "PENDING_VALIDATION",
        "ISSUED",
        "INACTIVE",
        "EXPIRED",
        "VALIDATION_TIMED_OUT",
        "REVOKED",
        "FAILED"
      ]
    },
    "CertificateSummary": {
      "type": "object",
      "properties": {
        "certificateArn": {
          "allOf": [
            {
              "$ref": "#/$defs/NonEmptyString"
            }
          ],
          "description": "The Amazon Resource Name (ARN) of the certificate."
        },
        "certificateName": {
          "allOf": [
            {
              "$ref": "#/$defs/CertificateName"
            }
          ],
          "description": "The name of the certificate."
        },
        "domainName": {
          "allOf": [
            {
              "$ref": "#/$defs/DomainName"
            }
          ],
          "description": "The domain name of the certificate."
        },
        "certificateDetail": {
          "allOf": [
            {
              "$ref": "#/$defs/Certificate"
            }
          ],
          "description": "An object that describes a certificate in detail."
        },
        "tags": {
          "allOf": [
            {
              "$ref": "#/$defs/TagList"
            }
          ],
          "description": "The tag keys and optional values for the resource. For more information about tags in Lightsail, see the Amazon Lightsail Developer Guide ."
        }
      },
      "description": "Describes an Amazon Lightsail SSL/TLS certificate."
    },
    "CertificateSummaryList": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/CertificateSummary"
      }
    },
    "DnsRecordCreationState": {
      "type": "object",
      "properties": {
        "code": {
          "allOf": [
            {
              "$ref": "#/$defs/DnsRecordCreationStateCode"
            }
          ],
          "description": "The status code for the automated DNS record creation. Following are the possible values: SUCCEEDED - The validation records were successfully added to the domain. STARTED - The automatic DNS record creation has started. FAILED - The validation records failed to be added to the domain."
        },
        "message": {
          "allOf": [
            {
              "$ref": "#/$defs/string"
            }
          ],
          "description": "The message that describes the reason for the status code."
        }
      },
      "description": "Describes the creation state of the canonical name (CNAME) records that are automatically added by Amazon Lightsail to the DNS of a domain to validate domain ownership for an SSL/TLS certificate. When you create an SSL/TLS certificate for a Lightsail resource, you must add a set of CNAME records to the DNS of the domains for the certificate to validate that you own the domains. Lightsail can automatically add the CNAME records to the DNS of the domain if the DNS zone for the domain exists within your Lightsail account. If automatic record addition fails, or if you manage the DNS of your domain using a third-party service, then you must manually add the CNAME records to the DNS of your domain. For more information, see Verify an SSL/TLS certificate in Amazon Lightsail in the Amazon Lightsail Developer Guide ."
    },
    "DnsRecordCreationStateCode": {
      "type": "string",
      "enum": [
        "SUCCEEDED",
        "STARTED",
        "FAILED"
      ]
    },
    "DomainName": {
      "type": "string"
    },
    "DomainValidationRecord": {
      "type": "object",
      "properties": {
        "domainName": {
          "allOf": [
            {
              "$ref": "#/$defs/DomainName"
            }
          ],
          "description": "The domain name of the certificate validation record. For example, example.com or www.example.com ."
        },
        "resourceRecord": {
          "allOf": [
            {
              "$ref": "#/$defs/ResourceRecord"
            }
          ],
          "description": "An object that describes the DNS records to add to your domain's DNS to validate it for the certificate."
        },
        "dnsRecordCreationState": {
          "allOf": [
            {
              "$ref": "#/$defs/DnsRecordCreationState"
            }
          ],
          "description": "An object that describes the state of the canonical name (CNAME) records that are automatically added by Lightsail to the DNS of the domain to validate domain ownership."
        },
        "validationStatus": {
          "allOf": [
            {
              "$ref": "#/$defs/CertificateDomainValidationStatus"
            }
          ],
          "description": "The validation status of the record."
        }
      },
      "description": "Describes the domain name system (DNS) records that you must add to the DNS of your registered domain to validate ownership for an Amazon Lightsail SSL/TLS certificate."
    },
    "DomainValidationRecordList": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/DomainValidationRecord"
      }
    },
    "EligibleToRenew": {
      "type": "string"
    },
    "InUseResourceCount": {
      "type": "integer"
    },
    "IsoDate": {
      "type": "string",
      "format": "date-time"
    },
    "IssuerCA": {
      "type": "string"
    },
    "KeyAlgorithm": {
      "type": "string"
    },
    "NonEmptyString": {
      "type": "string",
      "pattern": "\\S"
    },
    "RenewalStatus": {
      "type": "string",
      "enum": [
        "PendingAutoRenewal",
        "PendingValidation",
        "Success",
        "Failed"
      ]
    },
    "RenewalStatusReason": {
      "type": "string"
    },
    "RenewalSummary": {
      "type": "object",
      "properties": {
        "domainValidationRecords": {
          "allOf": [
            {
              "$ref": "#/$defs/DomainValidationRecordList"
            }
          ],
          "description": "An array of objects that describe the domain validation records of the certificate."
        },
        "renewalStatus": {
          "allOf": [
            {
              "$ref": "#/$defs/RenewalStatus"
            }
          ],
          "description": "The renewal status of the certificate. The following renewal status are possible: PendingAutoRenewal - Lightsail is attempting to automatically validate the domain names of the certificate. No further action is required. PendingValidation - Lightsail couldn't automatically validate one or more domain names of the certificate. You must take action to validate these domain names or the certificate won't be renewed. Check to make sure your certificate's domain validation records exist in your domain's DNS, and that your certificate remains in use. Success - All domain names in the certificate are validated, and Lightsail renewed the certificate. No further action is required. Failed - One or more domain names were not validated before the certificate expired, and Lightsail did not renew the certificate. You can request a new certificate using the CreateCertificate action."
        },
        "renewalStatusReason": {
          "allOf": [
            {
              "$ref": "#/$defs/RenewalStatusReason"
            }
          ],
          "description": "The reason for the renewal status of the certificate."
        },
        "updatedAt": {
          "allOf": [
            {
              "$ref": "#/$defs/IsoDate"
            }
          ],
          "description": "The timestamp when the certificate was last updated."
        }
      },
      "description": "Describes the status of a SSL/TLS certificate renewal managed by Amazon Lightsail."
    },
    "RequestFailureReason": {
      "type": "string"
    },
    "ResourceRecord": {
      "type": "object",
      "properties": {
        "name": {
          "allOf": [
            {
              "$ref": "#/$defs/string"
            }
          ],
          "description": "The name of the record."
        },
        "type": {
          "allOf": [
            {
              "$ref": "#/$defs/string"
            }
          ],
          "description": "The DNS record type."
        },
        "value": {
          "allOf": [
            {
              "$ref": "#/$defs/string"
            }
          ],
          "description": "The value for the DNS record."
        }
      },
      "description": "Describes the domain name system (DNS) records to add to your domain's DNS to validate it for an Amazon Lightsail certificate."
    },
    "RevocationReason": {
      "type": "string"
    },
    "SerialNumber": {
      "type": "string"
    },
    "SubjectAlternativeNameList": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/DomainName"
      }
    },
    "Tag": {
      "type": "object",
      "properties": {
        "key": {
          "allOf": [
            {
              "$ref": "#/$defs/TagKey"
            }
          ],
          "description": "The key of the tag. Constraints: Tag keys accept a maximum of 128 letters, numbers, spaces in UTF-8, or the following characters: + - = . _ : / @"
        },
        "value": {
          "allOf": [
            {
              "$ref": "#/$defs/TagValue"
            }
          ],
          "description": "The value of the tag. Constraints: Tag values accept a maximum of 256 letters, numbers, spaces in UTF-8, or the following characters: + - = . _ : / @"
        }
      },
      "description": "Describes a tag key and optional value assigned to an Amazon Lightsail resource. For more information about tags in Lightsail, see the Amazon Lightsail Developer Guide ."
    },
    "TagKey": {
      "type": "string"
    },
    "TagList": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/Tag"
      }
    },
    "TagValue": {
      "type": "string"
    },
    "string": {
      "type": "string"
    }
  }
}