---
title: "Get ACME contract details"
source_url: https://dev.digicert.com/partner-subscriptions-api/acme-contract-management/get-acme-contract-details.html
api_method: GET
api_endpoint: "/partner-subscription/api/v1/acme/<acme_contract_id>"
api_url: "https://www.digicert.com/partner-subscription/api/v1/acme/{{acme_contract_id}}"
---

**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**

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

**Python**

```python
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)
```

**Go**

```go
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))

}
```

**NodeJS**

```javascript
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

**DV contract**

```json
{
  "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
}
```

**OV contract**

```json
{
  "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
}
```

**EV contract**

```json
{
  "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

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Req/Opt</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>acme_contract_id</td>
<td>required</td>
<td>integer</td>
<td>Unique identifier of the ACME contract.</td>
</tr>
</tbody>
</table>


## Request parameters

This endpoint does not use request body parameters.

## Response parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>acme_contract_id</td>
<td>integer</td>
<td>Unique identifier for the ACME contract.</td>
</tr>
<tr>
<td>account_id</td>
<td>integer</td>
<td>Identifier of the account associated with the ACME contract.</td>
</tr>
<tr>
<td>product_name_id</td>
<td>string</td>
<td>Product identifier for the certificate type.</td>
</tr>
<tr>
<td>created_at</td>
<td>string</td>
<td>Contract creation date in ISO 8601 format.</td>
</tr>
<tr>
<td>sans</td>
<td>array[string]</td>
<td>Active Subject Alternative Names associated with the ACME contract.</td>
</tr>
<tr>
<td>valid_till</td>
<td>string</td>
<td>Contract expiration date in ISO 8601 format.</td>
</tr>
<tr>
<td>organization</td>
<td>object|null</td>
<td>Organization details associated with the ACME contract. Returns <code>null</code> for DV products.</td>
</tr>
<tr>
<td>.. assumed_name</td>
<td>string</td>
<td>Assumed name or public name of the organization. Also called Doing Business As (DBA) name.</td>
</tr>
<td>.. name</td>
<td>string</td>
<td>Legal organization name.</td>
</tr>
<tr>
<td>.. address</td>
<td>string</td>
<td>Street address of the organization.</td>
</tr>
<tr>
<td>.. address2</td>
<td>string</td>
<td>Additional address information, such as suite, floor, or unit.</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 or province where the organization is located.</td>
</tr>
<tr>
<td>.. zip</td>
<td>string</td>
<td>Postal or ZIP code of the organization.</td>
</tr>
<tr>
<td>.. country</td>
<td>string</td>
<td>Two-letter country code for the organization.</td>
</tr>
<tr>
<td>.. telephone</td>
<td>string</td>
<td>Organization phone number.</td>
</tr>
<tr>


<tr>
<td>is_organization_validated</td>
<td>boolean</td>
<td>Indicates whether the organization has valid OV or EV validation matching the contract product type.</td>
</tr>
<tr>
<td>auto_renew</td>
<td>boolean</td>
<td>Indicates whether auto-renewal is enabled for the ACME contract.</td>
</tr>
<tr>
<td>date_canceled</td>
<td>string|null</td>
<td>Date the contract was canceled in ISO 8601 format. If the contract is active, the response displays <code>null</code>.</td>
</tr>
</tbody>
</table>