Request info

GET https://www.digicert.com/services/v2/request/{{request_id}}

Use this endpoint to get details for a request.

Example requests and responses

Example 1. cURL

curl -X GET \
  https://www.digicert.com/services/v2/request/{{request_id}}\
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}'

Example 2. Python

import requests

url = "https://www.digicert.com/services/v2/request/{{request_id}}"

headers = {
    'X-DC-DEVKEY': "{{api_key}}",
    'Content-Type': "application/json"
    }

response = requests.request("GET", url, headers=headers)

print(response.text)

Example 3. Go

package main

import (
	"fmt"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://www.digicert.com/services/v2/request/{{request_id}}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-DC-DEVKEY", "{{api_key}}")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}

Example 4. NodeJS

var request = require("request");

var options = { method: 'GET',
  url: 'https://www.digicert.com/services/v2/request/{{request_id}}',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

Example 5. 200 OK

{
  "id": 198,
  "date": "2018-10-16T20:05:28+00:00",
  "type": "new_request",
  "status": "approved",
  "date_processed": "2018-11-02T16:44:19+00:00",
  "requester": {
    "id": 14,
    "first_name": "John",
    "last_name": "Smith",
    "email": "john.smith@digicert.com"
  },
  "reviewer": {
    "id": 14,
    "first_name": "John",
    "last_name": "Smith",
    "email": "john.smith@digicert.com"
  },
  "processor": {
    "id": 14,
    "first_name": "John",
    "last_name": "Smith",
    "email": "john.smith@digicert.com"
  },
  "order": {
    "id": 12345678,
    "certificate": {
      "common_name": "example.com",
      "dns_names": [
        "example.com",
        "www.example.com"
      ],
      "date_created": "2018-10-16T20:05:28+00:00",
      "csr": "<csr>",
      "organization": {
        "id": 112233
      },
      "organization_units": [
        "Not Fake Company Inc."
      ],
      "server_platform": {
        "id": -1,
        "name": "OTHER",
        "install_url": "http://www.digicert.com/SSL-certificate-installation.htm",
        "csr_url": "http://www.digicert.com/csr-creation.htm"
      },
      "signature_hash": "sha256",
      "key_size": 2048,
      "ca_cert": {
        "id": "<ca_cert_id>",
        "name": "DigiCert SHA2 Secure Server CA"
      }
    },
    "status": "needs_approval",
    "is_renewal": false,
    "date_created": "2018-10-16T20:05:28+00:00",
    "organization": {
      "id": 112233,
      "name": "Epigyne Unwieldiness llcasdf",
      "assumed_name": "Epigyne Unwieldiness",
      "display_name": "Epigyne Unwieldiness llcasdf (Epigyne Unwieldiness)",
      "city": "Minneapolis",
      "state": "Minnesota",
      "country": "us"
    },
    "validity_years": 1,
    "disable_renewal_notifications": false,
    "auto_renew": 0,
    "container": {
      "id": 5,
      "name": "History Department",
      "is_active": true
    },
    "product": {
      "name_id": "ssl_plus",
      "type": "ssl_certificate",
      "validation_type": "ov",
      "validation_name": "OV",
      "validation_description": "Normal Organization Validation"
    },
    "organization_contact": {
      "first_name": "Gia",
      "last_name": "Booth",
      "email": "gia.booth@inbox.com",
      "job_title": "Clinical Laboratory Technician",
      "telephone": "666-186-6450",
      "telephone_extension": "736"
    },
    "technical_contact": {
      "first_name": "Gia",
      "last_name": "Booth",
      "email": "gia.booth@inbox.com",
      "job_title": "Clinical Laboratory Technician",
      "telephone": "666-186-6450",
      "telephone_extension": "736"
    },
    "user": {
      "id": 14,
      "first_name": "John",
      "last_name": "Smith",
      "email": "john.smith@digicert.com"
    },
    "requests": [
      {
        "id": 198,
        "date": "2018-10-16T20:05:28+00:00",
        "type": "new_request",
        "status": "pending",
        "comments": "Form autofill."
      }
    ],
    "unsubmitted_domains": [
      "underlier-stanislavsky.org"
    ],
    "price": 175,
    "is_out_of_contract": false,
    "payment_method": "balance",
    "product_name_id": "ssl_plus",
    "disable_issuance_email": false,
    "renewal_of_order_valid_till": "2021-06-20"
  },
  "comments": "New certificate."
}

Example 6. 200 OK (pending)

{
  "id": 198,
  "date": "2018-10-16T20:05:28+00:00",
  "type": "new_request",
  "status": "pending",
  "requester": {
    "id": 14,
    "first_name": "John",
    "last_name": "Smith",
    "email": "john.smith@digicert.com"
  },
  "order": {
    "id": 12345678,
    "certificate": {
      "common_name": "example.com",
      "dns_names": [
        "example.com",
        "www.example.com"
      ],
      "date_created": "2018-10-16T20:05:28+00:00",
      "csr": "<csr>",
      "organization": {
        "id": 112233
      },
      "organization_units": [
        "Not Fake Company Inc."
      ],
      "server_platform": {
        "id": -1,
        "name": "OTHER",
        "install_url": "http://www.digicert.com/SSL-certificate-installation.htm",
        "csr_url": "http://www.digicert.com/csr-creation.htm"
      },
      "signature_hash": "sha256",
      "key_size": 2048,
      "ca_cert": {
        "id": "<ca_cert_id>",
        "name": "DigiCert SHA2 Secure Server CA"
      }
    },
    "status": "needs_approval",
    "is_renewal": false,
    "date_created": "2018-10-16T20:05:28+00:00",
    "organization": {
      "id": 112233,
      "name": "Epigyne Unwieldiness llcasdf",
      "assumed_name": "Epigyne Unwieldiness",
      "display_name": "Epigyne Unwieldiness llcasdf (Epigyne Unwieldiness)",
      "city": "Minneapolis",
      "state": "Minnesota",
      "country": "us"
    },
    "validity_years": 1,
    "disable_renewal_notifications": false,
    "auto_renew": 0,
    "container": {
      "id": 5,
      "name": "History Department",
      "is_active": true
    },
    "product": {
      "name_id": "ssl_plus",
      "type": "ssl_certificate",
      "validation_type": "ov",
      "validation_name": "OV",
      "validation_description": "Normal Organization Validation"
    },
    "organization_contact": {
      "first_name": "Gia",
      "last_name": "Booth",
      "email": "gia.booth@inbox.com",
      "job_title": "Clinical Laboratory Technician",
      "telephone": "666-186-6450",
      "telephone_extension": "736"
    },
    "technical_contact": {
      "first_name": "Gia",
      "last_name": "Booth",
      "email": "gia.booth@inbox.com",
      "job_title": "Clinical Laboratory Technician",
      "telephone": "666-186-6450",
      "telephone_extension": "736"
    },
    "user": {
      "id": 14,
      "first_name": "John",
      "last_name": "Smith",
      "email": "john.smith@digicert.com"
    },
    "requests": [
      {
        "id": 198,
        "date": "2018-10-16T20:05:28+00:00",
        "type": "new_request",
        "status": "pending",
        "comments": "Form autofill."
      }
    ],
    "unsubmitted_domains": [
      "underlier-stanislavsky.org"
    ],
    "price": 175,
    "is_out_of_contract": false,
    "payment_method": "balance",
    "product_name_id": "ssl_plus",
    "disable_issuance_email": false,
    "renewal_of_order_valid_till": "2021-06-20"
  },
  "comments": "New certificate."
}

Response parameters

Name	Type	Description
id	int	Request ID.
date	string	Timestamp of when the request was submitted. Format: UTC timezone and ISO 8601 date
type	string	Request type. Possible values: `new_request`, `revoke`, `duplicate`, `reissue`, `renew`
status	string	Status of the request. Possible values: `submitted`, `pending`, `approved`, `rejected`
date_processed	string	Timestamp of when the request was processed. Not returned if status is `pending`. Format: UTC timezone and ISO 8601 date
requester	object	Details about the user that submitted the request. See Structures – User details object.
reviewer	object	Details about the user that reviewed the request. See Structures – User details object.
processor	object	Details about the user that processed the request. See Structures – User details object.
order	object	Details about the order associated with the request.
.. unsubmitted_domains	array	List of domains submitted with the request that have not been validated or added to the account.
.. renewal_of_order_valid_till	string	Expiration date of the order being renewed. Only returned for renewal requests. Format:`YYYY-MM-DD`
comments	string	Message about the request.

In this section: