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

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

Use this endpoint to retrieve certificate details for certificates issued under an ACME contract.

The response returns a list of certificate records associated with the contract. Each record includes the certificate domain, current status, expiration date, serial number, and SANs included in that certificate.


> **Info**
>
> This endpoint requires a subaccount Partner Subscriptions API key. Parent account API keys are not accepted for ACME contract operations. Also, this endpoint does not retrieve the certificate files, PEM data, or certificate chain data.


## Example requests and responses

**cURL**

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

**Python**

```python
import requests

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

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/certificates"

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

	req.Header.Add("X-PARTNER-APIKEY", "{{subaccount_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/certificates',
  headers: {
    'X-PARTNER-APIKEY': '{{subaccount_partner_api_key}}'
  }
};

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

  console.log(body);
});
```


## 200 OK

```json
{
  "certificates": [
    {
      "domain": "example.com",
      "status": "issued",
      "expiration_date": "2025-07-15T12:00:00Z",
      "serial_number": "0A1B2C3D4E5F6A7B8C9D0E1F2A3B4C5D",
      "sans": [
        "example.com",
        "www.example.com"
      ]
    },
    {
      "domain": "api.example.com",
      "status": "issued",
      "expiration_date": "2025-08-20T12:00:00Z",
      "serial_number": "1B2C3D4E5F6A7B8C9D0E1F2A3B4C5D6E",
      "sans": [
        "api.example.com"
      ]
    }
  ]
}
```

## 200 OK - No certificates

```json
{
  "certificates": []
}
```


## 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>certificates</td>
<td>array[object]</td>
<td>List of certificate records associated with the ACME contract. Returns an empty array if no certificates are available.</td>
</tr>
<tr>
<td>.. domain</td>
<td>string</td>
<td>Domain associated with the certificate record.</td>
</tr>
<tr>
<td>.. status</td>
<td>string</td>
<td>Current status of the certificate.
<br>Status types: <code>issued</code>, <code>pending</code>, <code>renewed</code>, <code>not_renewed</code>, <code>expired</code>, or <code>revoked</code>.</td>
</tr>
<tr>
<td>.. expiration_date</td>
<td>string|null</td>
<td>Certificate expiration date in ISO 8601 format, or <code>null</code> if the certificate has not been issued.</td>
</tr>
<tr>
<td>.. serial_number</td>
<td>string|null</td>
<td>Certificate serial number, or <code>null</code> if the certificate has not been issued.</td>
</tr>
<tr>
<td>.. sans</td>
<td>array[string]</td>
<td>Subject Alternative Names included in the certificate.</td>
</tr>
</tbody>
</table>