Get ACME contract details

3 minute read

GET https://www.digicert.com/partner-subscription/api/v1/acme/{{acme_contract_id}}

Use this endpoint to retrieve details of an existing ACME contract.

The response includes contract details such as the product identifier, SANs, contract expiration date, auto-renewal status, cancellation status, and organization validation status. For OV and EV products, the response includes organization details.

Example requests and responses

curl -X GET \
  https://www.digicert.com/partner-subscription/api/v1/acme/12345 \
  -H 'X-PARTNER-APIKEY: {{subaccount_partner_api_key}}'

import requests

url = "https://www.digicert.com/partner-subscription/api/v1/acme/12345"

headers = {
    'X-PARTNER-APIKEY': "{{subaccount_partner_api_key}}"
    }

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

print(response.text)

package main

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

func main() {

	url := "https://www.digicert.com/partner-subscription/api/v1/acme/12345"

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

	req.Header.Add("X-PARTNER-APIKEY", "{{partner_api_key}}")

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

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

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

}

var request = require("request");

var options = {
  method: 'GET',
  url: 'https://www.digicert.com/partner-subscription/api/v1/acme/12345',
  headers: {
    'X-PARTNER-APIKEY': '{{partner_api_key}}'
  }
};

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

  console.log(body);
});

200 OK

{
  "acme_contract_id": 12345,
  "account_id": 67890,
  "product_name_id": "ssl_dv_rapidssl",
  "created_at": "2025-01-29T10:30:00Z",
  "sans": [
    "example.com",
    "www.example.com",
    "*.example.com"
  ],
  "valid_till": "2027-01-29T10:30:00Z",
  "organization": null,
  "is_organization_validated": false,
  "auto_renew": false,
  "date_canceled": null
}

{
  "acme_contract_id": 12345,
  "account_id": 67890,
  "product_name_id": "ssl_basic",
  "created_at": "2025-01-29T10:30:00Z",
  "sans": [
    "example.com",
    "www.example.com"
  ],
  "valid_till": "2027-01-29T10:30:00Z",
  "organization": {    
    "name": "Example Corporation",
     "assumed_name": "Example Corp",
    "address": "123 Main Street",
    "address2": "Suite 500",
    "city": "San Francisco",
    "state": "CA",
    "zip": "94105",
    "country": "US",
    "telephone": "+1-555-0100"    
  },
  "is_organization_validated": true,
  "auto_renew": false,
  "date_canceled": null
}

{
  "acme_contract_id": 12346,
  "account_id": 67890,
  "product_name_id": "ssl_ev_basic",
  "created_at": "2025-01-29T10:30:00Z",
  "sans": [
    "secure.example.com",
    "www.secure.example.com"
  ],
  "valid_till": "2027-01-29T10:30:00Z",
  "organization": {    
    "name": "Example Corporation",
     "assumed_name": "Example Corp",
    "address": "123 Main Street",
    "address2": "Suite 500",
    "city": "San Francisco",
    "state": "CA",
    "zip": "94105",
    "country": "US",
    "telephone": "+1-555-0100"    
  },
  "is_organization_validated": true,
  "auto_renew": false,
  "date_canceled": null
}

URL path and query parameters

Name	Req/Opt	Type	Description
acme_contract_id	required	integer	Unique identifier of the ACME contract.

Request parameters

This endpoint does not use request body parameters.

Response parameters

Name	Type	Description
acme_contract_id	integer	Unique identifier for the ACME contract.
account_id	integer	Identifier of the account associated with the ACME contract.
product_name_id	string	Product identifier for the certificate type.
created_at	string	Contract creation date in ISO 8601 format.
sans	array[string]	Active Subject Alternative Names associated with the ACME contract.
valid_till	string	Contract expiration date in ISO 8601 format.
organization	object\|null	Organization details associated with the ACME contract. Returns `null` for DV products.
.. assumed_name	string	Assumed name or public name of the organization. Also called Doing Business As (DBA) name.
.. name	string	Legal organization name.
.. address	string	Street address of the organization.
.. address2	string	Additional address information, such as suite, floor, or unit.
.. city	string	City where the organization is located.
.. state	string	State or province where the organization is located.
.. zip	string	Postal or ZIP code of the organization.
.. country	string	Two-letter country code for the organization.
.. telephone	string	Organization phone number.
is_organization_validated	boolean	Indicates whether the organization has valid OV or EV validation matching the contract product type.
auto_renew	boolean	Indicates whether auto-renewal is enabled for the ACME contract.
date_canceled	string\|null	Date the contract was canceled in ISO 8601 format. If the contract is active, the response displays `null`.