---
title: "View automation details"
source_url: https://dev.digicert.com/certcentral-apis/automation-api/view-automation-details.html
api_method: POST
api_endpoint: "/automationws/v1/automation/viewAutomationDetails"
api_url: "https://caas.digicert.com/automationws/v1/automation/viewAutomationDetails"
---

**POST** `https://caas.digicert.com/automationws/v1/automation/viewAutomationDetails`

Use this endpoint to view details about a specific automation instance.

## Example requests and responses

## cURL

```bash
curl --location --request POST 'https://caas.digicert.com/automationws/v1/automation/viewAutomationDetails' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "accountId": 5153184,
    "automationId": 298577,
    "divisionId": 677793
}'
```

## 200 OK

```json
{
    "error": null,
    "data": {
        "autoStatusResponse": {
            "automationStatus": "INSTALL_VALIDATION_FAILED",
            "requestedOn": "1599716536705",
            "installSettings": {
                "installationType": "AUTO_INSTALL_AFTER_APPROVAL",
                "isAlwaysOn": false
            },
            "userDetailsResponse": {
                "firstName": "CertCentral",
                "lastName": "Admin",
                "container": {
                    "id": 677793,
                    "name": "Cert Testing Inc."
                }
            }
        },
        "autoOrderProgressResponse": {
            "csrGenResponse": {
                "csrProgress": "CSR_GENERATION_SUCCEEDED"
            },
            "certInstallResponse": {
                "certInstallProgress": "INSTALL_VALIDATION_FAILED",
                "causeOfFailure": "Post install validation is unsuccessful, could be due to installation failure / scan failure",
                "solution": "Verify certificate manually on website and cancel this automation request if installed, otherwise retry. Contact customer support for additional help."
            },
            "isRetryApplicable": true
        },
        "certDetailsResponse": {
            "commonName": "cert-testing.com",
            "signatureHash": "",
            "orgDetails": {
                "name": "Cert Testing Inc.",
                "address": "2801 N Thanksgiving Way",
                "address2": "Suite 500",
                "city": "Lehi",
                "state": "Utah",
                "telephone": "801-701-9600"
            },
            "sans": "",
            "automationProfileName": "22jul2020 01",
            "automationProfileId": 741.0,
            "automationProfileStatus": "ACTIVE",
            "productType": "SSL_SECURESITE_FLEX",
            "validityPeriod": "1Y"
        },
        "isRequestApproval": false
    }
}
```

## Request parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Req/Opt</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>accountId</td>
<td>required</td>
<td>string</td>
<td>Account ID.</td>
</tr>
<tr>
<td>automationId</td>
<td>required</td>
<td>string</td>
<td>Automation ID.</td>
</tr>
<tr>
<td>divisionId</td>
<td>required</td>
<td>string</td>
<td>Division ID.</td>
</tr>
</tbody>
</table>

## Response parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>error</td>
<td>object</td>
<td>Object with error details.</td>
</tr>
<tr>
<td>data</td>
<td>object</td>
<td>Object with response data.</td>
</tr>
<tr>
<td>.. autoStatusResponse</td>
<td>object</td>
<td>Object container for automation status details.</td>
</tr>
<tr>
<td>.. .. automationStatus</td>
<td>string</td>
<td>Status of the automation.<br>Possible values: ACTION_REQUIRED, SUCCESFULLY_RENEWED, AUTO_RENEW_SCHEDULED, AUTOMATION_FAILED, AUTOMATION_SCHEDULED, CONFIGURED,  INSTALL_VALIDATION_FAILED, INSTALL_FAILED, ERROR.</td>
</tr>
<tr>
<td>.. .. requestedOn</td>
<td>integer</td>
<td>Request date and time of the automation.<br>Format: epoch in milliseconds.<br>An epoch corresponds to 0 hours, 0 minutes, and 0 seconds (00:00:00) Coordinated Universal Time (UTC) on a specific date, which varies from system to system.<br>Example: 1596781119000</td>
</tr>
<tr>
<td>.. .. lastRunTime</td>
<td>integer</td>
<td>Date and time when the automation was last run.</td>
</tr>
<tr>
<td>.. .. nextRenewalDate</td>
<td>integer</td>
<td>Date and time when the automation is scheduled for renewal.</td>
</tr>
<tr>
<td>.. .. message</td>
<td>string</td>
<td>Message when agent or sensor is down and automation is already scheduled.</td>
</tr>
<tr>
<td>.. .. installSettings</td>
<td>object</td>
<td>Object with installation settings.</td>
</tr>
<tr>
<td>.. .. .. installationType</td>
<td>string</td>
<td>Certificate installation type. Certificate installation can either be on-demand or scheduled for a specific time.<br><ul><li>AUTO_INSTALL_AFTER_APPROVAL: Install the certificate immediately after approval (on demand).</li><li>SCHEDULED_INSTALL: Schedule the certificate installation for a later date/time.</li></ul></td>
</tr>
<tr>
<td>.. .. .. isAlwaysOn</td>
<td>boolean</td>
<td>Whether to auto-renew and install certificates. If true, you must specify autoRenewSettings in your request.<br>Default: false</td>
</tr>
<tr>
<td>.. .. .. scheduleTime</td>
<td>integer</td>
<td>Time when automation starts.<br>Format: epoch in milliseconds.<br>An epoch corresponds to 0 hours, 0 minutes, and 0 seconds (00:00:00) Coordinated Universal Time (UTC) on a specific date, which varies from system to system.<br>Example: 1598299200000<br>*If you choose installationType as SCHEDULED_INSTALL.</td>
</tr>
<tr>
<td>.. .. .. scheduleTimeZone</td>
<td>string</td>
<td>Time zone for the automation.<br>Format:  GMT + your timezone offset.<br>Example: 
 -8#pacifictime<br>*If you choose installationType as SCHEDULED_INSTALL.</td>
</tr>
<tr>
<td>.. .. .. autoRenewSettings</td>
<td>object</td>
<td>Object with auto-renew settings.</td>
</tr>
<tr>
<td>.. .. .. .. daysBeforeExpiry</td>
<td>integer</td>
<td>Number of days to renew the certificate before certificate expiration.<br>Min: 1 day<br>Max: Less than the certificate validity.</td>
</tr>
<tr>
<td>.. .. .. .. scheduleTime</td>
<td>integer</td>
<td>Time when auto-renew starts.<br>Format: epoch in milliseconds.<br>An epoch corresponds to 0 hours, 0 minutes, and 0 seconds (00:00:00) Coordinated Universal Time (UTC) on a specific date, which varies from system to system.<br>Example: 1596781119000</td>
</tr>
<tr>
<td>.. .. .. .. scheduleTimeZone</td>
<td>string</td>
<td>Time zone for the auto-renew.<br>Format:  GMT + your timezone offset.<br>Example: 
 -8#pacifictime</td>
</tr>
<tr>
<td>.. .. .. .. isAutoReplace</td>
<td>boolean</td>
<td>For a revoked or missing certificate, <code>true</code> requests and installs the certificate on the host.<br>Default: false</td>
</tr>
<tr>
<td>.. .. userDetailsResponse</td>
<td>object</td>
<td>Object container for user details.</td>
</tr>
<tr>
<td>.. .. .. firstName</td>
<td>string</td>
<td>First name of user that requested the automation.</td>
</tr>
<tr>
<td>.. .. .. lastName</td>
<td>string</td>
<td>Last name of user that requested the automation.</td>
</tr>
<tr>
<td>.. .. .. container</td>
<td>object</td>
<td>Primary container the user is attached to.</td>
</tr>
<tr>
<td>.. .. .. .. id</td>
<td>integer</td>
<td>Container ID.</td>
</tr>
<tr>
<td>.. .. .. .. name</td>
<td>string</td>
<td>Name of the container.</td>
</tr>
<tr>
<td>.. autoOrderProgressResponse</td>
<td>object</td>
<td>Object container for the automation order progress.</td>
</tr>
<tr>
<td>.. .. csrGenResponse</td>
<td>object</td>
<td>Object container for CSR generation details.</td>
</tr>
<tr>
<td>.. .. .. csrProgress</td>
<td>string</td>
<td>CSR generation status.</td>
</tr>
<tr>
<td>.. .. .. causeOfFailure</td>
<td>string</td>
<td>Message describing the cause of failure.</td>
</tr>
<tr>
<td>.. .. .. solution</td>
<td>string</td>
<td>Solution message.</td>
</tr>
<tr>
<td>.. .. postCsrGenResponse</td>
<td>object</td>
<td>Object container for post-CSR generation failure details.</td>
</tr>
<tr>
<td>.. .. .. postCSRProgress</td>
<td>string</td>
<td>Status of post-CSR generation failure.</td>
</tr>
<tr>
<td>.. .. .. causeOfFailure</td>
<td>string</td>
<td>Message describing the cause of failure.</td>
</tr>
<tr>
<td>.. .. .. solution</td>
<td>string</td>
<td>Solution message.</td>
</tr>
<tr>
<td>.. ..  certInstallResponse</td>
<td>object</td>
<td>Object container for certificate installation details.</td>
</tr>
<tr>
<td>.. .. .. certInstallProgress</td>
<td>string</td>
<td>Status of certificate installation.<br>Allowed values: AUTOMATION_SCHEDULED, CERT_READY_TO_INSTALL, INSTALL_IN_PROGRESS, INSTALL_FAILED, INSTALL_SUCCEEDED, INSTALL_VALIDATION_IN_PROGRESS, INSTALL_VALIDATION_FAILED, INSTALL_VALIDATED, AUTOMATION_FAILED.</td>
</tr>
<tr>
<td>.. .. .. scheduleOn</td>
<td>string</td>
<td>Time when the certificate installation is scheduled.<br>*If certInstallProgress status is AUTOMATION_SCHEDULED.</td>
</tr>
<tr>
<td>.. .. .. causeOfFailure</td>
<td>string</td>
<td>Message describing the cause of failure.</td>
</tr>
<tr>
<td>.. .. .. solution</td>
<td>string</td>
<td>Solution message.</td>
</tr>
<tr>
<td>.. .. isRetryApplicable</td>
<td>boolean</td>
<td>Whether to retry the automation, if it fails. If true, retry is initiated.</td>
</tr>
<tr>
<td>.. certDetailsResponse</td>
<td>object</td>
<td>Object container for certificate details.</td>
</tr>
<tr>
<td>.. .. commonName</td>
<td>string</td>
<td>Common name of the certificate.</td>
</tr>
<tr>
<td>.. .. signatureHash</td>
<td>string</td>
<td>Hash type ID for the algorithm used to sign the certificate.<br>Allowed values: See <a href="https://dev.digicert.com/md/certcentral-apis/services-api/glossary.md#hash-types">Glossary – Hash types</a></td>
</tr>
<tr>
<td>.. .. orgDetail</td>
<td>object</td>
<td>Object container for organization details.</td>
</tr>
<tr>
<td>.. .. .. name</td>
<td>string</td>
<td>Name of the organization.</td>
</tr>
<tr>
<td>.. .. .. address</td>
<td>string</td>
<td>Address of the organization.</td>
</tr>
<tr>
<td>.. .. .. address2</td>
<td>string</td>
<td>Continuation of the address.</td>
</tr>
<tr>
<td>.. .. .. city</td>
<td>string</td>
<td>City where the organization is located.</td>
</tr>
<tr>
<td>.. .. .. state</td>
<td>string</td>
<td>State where the organization is located.</td>
</tr>
<tr>
<td>.. .. .. country</td>
<td>string</td>
<td>Country where the organization is located.</td>
</tr>
<tr>
<td>.. .. .. telephone</td>
<td>string</td>
<td>Organization telephone number.</td>
</tr>
<tr>
<td>.. .. sans</td>
<td>string</td>
<td>Comma-separated list of additional subject alternative names (SANs) to secure with automated certificate requests.</td>
</tr>
<tr>
<td>.. .. automationProfileName</td>
<td>string</td>
<td>Name of the automation profile.</td>
</tr>
<tr>
<td>.. .. automationProfileId</td>
<td>integer</td>
<td>Profile ID associated with the automation.</td>
</tr>
<tr>
<td>.. .. automationProfileStatus</td>
<td>string</td>
<td>Status of the automation profile.<br>Allowed values: ACTIVE, ACTION_NEEDED.</td>
</tr>
<tr>
<td>.. .. productType</td>
<td>string</td>
<td>Type of the product.<br><strong>Allowed values:</strong> See <a href="https://dev.digicert.com/md/certcentral-apis/services-api/glossary.md#product-identifiers">Glossary – Product identifiers.</a></td>
</tr>
<tr>
<td>.. .. validityPeriod</td>
<td>string</td>
<td>Certificate validity.<br>Allowed values: <code>1D</code>, <code>1Y</code> End the string with D or Y.<br>Example: 
 1Y<br>Max value: 
 397 days</td>
</tr>
<tr>
<td>.. isRequestApproval</td>
<td>boolean</td>
<td>Auto-approval of certificate request.</td>
</tr>
</tbody>
</table>