Order validation status
GET https://www.digicert.com/services/v2/order/certificate/{{order_id}}/validation
Use this endpoint to get the validation status of an order. Response data varies depending on the type of certificate and the status of the validation components.
Example requests and responses
Path parameters
Name | Req/Opt | Type | Description |
---|---|---|---|
order_id | required | string | Order ID. |
Response parameters
Name | Type | Description |
---|---|---|
order_id | string | Order ID. |
order_status | string | Status of the order. See Glossary – Order status |
organization_id | string | Organization ID. |
organization_name | string | Organization name. |
organization_validations | array | List of objects with details about organization validations that must be complete before DigiCert can issue the certificate. Note: The |
.. type | string | Validation type ID. See Glossary – Validation types. |
.. name | string | Friendly name of the validation type. |
.. description | string | Description of the validation type. |
.. date_created | string | Timestamp when validation was completed. UTC timezone and ISO 8601 date. |
.. validated_until | string | Timestamp when validation will expire. UTC timezone and ISO 8601 date. |
.. status | string | Validation status. Possible values: |
.. verified_contacts | array | List of objects with details about verified contacts for the organization. |
.. .. user_id | string | Contact user ID. Returns |
.. .. name | string | Contact name. |
.. .. first_name | string | Contact first name. |
.. .. last_name | string | Contact last name. |
.. .. job_title | string | Contact job title. |
.. .. telephone | string | Contact telephone number. |
string | Contact email address. | |
.. .. status | string | Contact approval status. Possible values: |
.. verification_details | object | Object containing the status of each component involved in verifying your certificate request. |
.. .. organization_type | string | Status of verification of organization type. Only returned for OV certificate orders. Possible values: |
.. .. organization_status | string | Status of verification that the business is still active. Returned for OV, code signing, and doc signing certificate orders. Possible values: |
.. .. address_verification | string | Status of verification of the legal physical address for the organization. Returned for OV, code signing, and doc signing certificate orders. Possible values: |
.. .. blacklist_fraud | string | Status of verification that the organization doesn’t appear on "do not issue" lists or "bad actor" lists. Returned for EV, OV, doc signing, and VMC certificate orders. Possible values: |
.. .. blacklist_fraud_malware | string | Status of verification that the organization is not a known malware signer. Returned for code signing and EV code signing certificate orders. Possible values: |
.. .. request_authenticity | string | Status of verification that the certificate requestor has authority to order a certificate for the organization. Only returned for OV certificate orders. Possible values: |
.. .. operational_existence | string | Status of verification that the organization exists and is operational. Returned for EV, EV code signing, and VMC certificate orders. Possible values: |
.. .. place_of_business_verification | string | Status of verification of the organization’s place of business. Returned for EV, EV code signing, and VMC certificate orders. Possible values: |
.. .. phone_number_verification | string | Status of verification that the phone number given is valid and tied to the organization. Returned for EV, code signing, EV code signing, and VMC certificate orders. Possible values: |
.. .. approver_verification | string | Status of verification that the approver is valid for this organization. Returned for EV, code signing, EV code signing, and VMC certificate orders. Possible values: |
.. .. approver_blacklist | string | Status of verification that the approver doesn’t appear on "do not issue" or "bad actor" lists. Returned for EV, code signing, EV code signing, and VMC certificate orders. Possible values: |
.. .. logo_trademark | string | Status of verification that the logo is a registered trademark for the organization on the order. Only returned for VMC certificate orders. Possible values: |
dns_name_validations | array | List of objects with validation details for each domain on the order. Returned for EV, OV, DV, and VMC certificate orders. |
.. domain_id | string | ID of the domain in your account that must be validated to prove control over the hostname in the |
.. status | string | Validation status. Possible values: |
.. method | string | DCV method used for the validated domain. Returned for DV, OV, EV, and VMC certificate orders. Note: Only returned for OV, EV, and VMC certificate orders if validation status is |
.. dns_names | array | List containing the SAN from the certificate order associated with the validation details in the |
.. approval_expiration_date | string | Date and time validation expires. UTC timezone and ISO 8601 date. Only returned if validation status is |
.. base_domain | string | Base domain of the hostname in the |