[REST API](https://zerossl.com/documentation/api "ZeroSSL Documentation") Verification Status
REST API Verification Status
Get Domain Verification StatusHTTPS GET
To retrieve information about the domain verification status for a specific certificate using the ZeroSSL API, simply make an HTTPS GET request to the API endpoint below, specifying your certificate using its ID (hash) inside the URL's {id} parameter, as shown below.
API Request URL:
api.zerossl.com/certificates/{id}/status
HTTPS GET Request Parameters:
| Parameter | Description |
|---|---|
access_key |
access_key[Required] Use this parameter to specify your API access key. |
{id} |
{id}[Required] Use this parameter to specify your certificate ID / hash. |
API Response:
If your API request has been successful, you will receive a JSON API response containing verification status information for each of the domains in your certificate.
{ "validation_completed": 0, "details": { "domain.com": { "method": "postmaster@domain.com", "status": "Email Sent" }, "www.domain.com": { "method": "postmaster@domain.com", "status": "Email Sent" } } }
Response Objects:
| Parameter | Description |
|---|---|
validation_completed |
validation_completedReturns 1 or 0 depending on whether domain verification has been completed. |
details |
detailsReturns a sub-object for each domain (or a pair of www and non-www domains) containing verification information. |
method |
methodReturns the verification email selected for the given domain. |
status |
statusReturns the current verification status of the given domain. |