Get Certificate Request

Retrieve a specific TLS certificate request.

Use the Get Certificate Request Status endpoint to retrieve more detailed status information.

Request

Retrieve a certificate request through the following request:

HTTP Method	Request URI
GET	https://api.vdms.io/sec/cps/v2.0/certificates/Certificate Request ID

Define the following variable when submitting the above request:

VariableA variable represents a value that must be replaced. A variable consists of either a URL segment (e.g., "0001" in /0001/) or a query string value (e.g., "3" in mediaTypes=3).	Description
Certificate Request ID Required	Replace this variable with the system-defined ID for the desired certificate request. Use the Get All Certificate Requests endpoint to retrieve a list of certificate requests and their system-defined ID.

Request Headers

This endpointIdentifies a request's connection point to our REST API service. only takes advantage of common request headers.

Unlike requests to api.edgecast.com, requests to our API gateway (api.vdms.io) require an access token (OAuth).

Request Body

Request body parameters are not required by this endpoint.

Response

The response to the above request includes an HTTP status code, response headers, and a response body.

Status Code

A status code indicates whether the request was successfully performed.

Response Headers

The response for this endpoint only includes standard HTTP response headers.

View common response headers.

Response Body

The response body for a successful request (200 OK) contains the following response elements:

Name	Data Type	Description
@id	String	Indicates the relative path to an endpoint through which you may retrieve the current certificate request.
@type	String	Returns Certificate.
auto_renew	Boolean	Indicates whether this certificate will automatically renew prior to its expiration date.
certificate_authority	String	Returns DigiCert.
certificate_label	String	Indicates the certificate's name.
created	String	Indicates the timestamp at which this request for a certificate was initially submitted. Syntax: YYYY-MM-DDThh:mm:ss.ffffffZ Learn more.
created_by	Object	Describes the user that submitted this certificate request.
dcv_method	String	Indicates the method through which your control over the domains associated with this certificate will be validated. Use the Get Domain Control Validation Types endpoint to retrieve a list of validation methods.
deployments	Array	Contains a list of delivery platforms to which this certificate has been deployed.
description	String	Indicates the certificate's description.
domains	Array of objects	Contains the certificate's domain(s).
expiration_date	String	Indicates the timestamp at which this certificate will expire. Syntax: YYYY-MM-DDThh:mm:ss.ffffffZ Learn more. If the Certificate Authority (CA) is still processing the certificate request, then this property returns the following timestamp: 0001-01-01T00:00:00Z
id	Integer	Indicates the system-defined ID assigned to this certificate.
last_modified	String	Indicates the timestamp at which this request for a certificate was last modified. Syntax: YYYY-MM-DDThh:mm:ss.ffffffZ Learn more.
modified_by	Object	Describes the user that last modified this certificate request.
organization	Object	Describes the certificate request's organization.
request_type	String	Returns Enterprise.
thumbprint	String	Indicates the certificate's thumbprint (aka fingerprint). If the CA is still processing the certificate request, then this property returns a null value.
validation_type	String	Indicates the certificate's level of validation. Learn more. Use the Get Certificate Validation Levels endpoint to retrieve a list of validation levels.
workflow_error_message		Returns a null value.

Errors

The response body for an unsuccessful request will contain an error response that provides additional information.

Sample Request and Response

A sample JSON request is shown below.

A sample JSON response is shown below.

{
	"@id": "/v2.0/certificates/11604",
	"@type": "Certificate",
	"domains": [{
			"name": "cdn-resources.example.com",
			"status": "Active",
			"active_date": null,
			"is_common_name": true,
			"created": "2021-02-18T21:40:49.921598Z",
			"id": 15230
		}
	],
	"certificate_authority": "DigiCert",
	"validation_type": "DV",
	"organization": null,
	"dcv_method": "DnsTxtToken",
	"certificate_label": "CDN resources certificate",
	"description": null,
	"last_modified": "2021-03-11T22:14:13.933637Z",
	"created": "2021-02-18T21:40:49.921598Z",
	"expiration_date": "2022-10-07T00:00:00Z",
	"request_type": "Enterprise",
	"thumbprint": "32C1DF418293CBF28517297067D16E8C1A853076",
	"deployments": [{
			"delivery_region": "GlobalPremiumAsiaPlusLatam",
			"platform": "HttpLarge",
			"hex_url": "cs123.wpc.0001.omegacdn.net"
		}
	],
	"created_by": {
		"user_id": null,
		"portal_type_id": null,
		"identity_id": "2cd24392-3edb-4f2d-9b1d-e089f9357n2c",
		"identity_type": "Client"
	},
	"modified_by": null,
	"workflow_error_message": null,
	"auto_renew": true,
	"id": 11604
}