---
title: "List account settings"
source_url: https://dev.digicert.com/partner-subscriptions-api/account-management/list-account-settings.html
api_method: GET
api_endpoint: "/partner-subscription/api/v1/account/settings"
api_url: "https://www.digicert.com/partner-subscription/api/v1/account/settings"
---

**GET** `https://www.digicert.com/partner-subscription/api/v1/account/settings`

Use this endpoint to retrieve all account settings for the authenticated Partner Subscriptions account.

Each setting includes the current value and indicates whether the account is using the system default or an account-specific override.


> **Info**
>
> - This endpoint returns account settings for the account authenticated by the `X-PARTNER-APIKEY` header. Use a parent account Partner Subscriptions API key to retrieve parent account settings. Use a subaccount Partner Subscriptions API key to retrieve settings for that subaccount.
> - The `auto_renew_subscription` setting controls the default auto-renewal behavior for new ACME contracts. When set to `1`, new ACME contracts default to auto-renew enabled unless explicitly disabled during contract creation. When set to `0`, new ACME contracts default to auto-renew disabled unless explicitly enabled during contract creation.


## Example requests and responses

**cURL**

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

**Python**

```python
import requests

url = "https://www.digicert.com/partner-subscription/api/v1/account/settings"

headers = {
    'X-PARTNER-APIKEY': "{{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/account/settings"

	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/account/settings',
  headers: {
    'X-PARTNER-APIKEY': '{{partner_api_key}}'
  }
};

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

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


## 200 OK

```json
[
  {
    "name": "auto_renew_subscription",
    "value": "0",
    "is_default": true
  }
]
```

## URL path and query parameters

This endpoint does not use URL path or query parameters.

## 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>name</td>
<td>string</td>
<td>Name of the account setting.
<br><br>
Supported settings:
<table class="params-table">
<thead>
<tr>
<th>Setting name</th>
<th>Valid values</th>
<th>Default</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>auto_renew_subscription</code></td>
<td><code>0</code>, <code>1</code></td>
<td><code>0</code></td>
<td>Controls the default auto-renewal behavior for new ACME contracts. When set to <code>1</code>, new ACME contracts default to auto-renew enabled unless explicitly overridden at contract creation.</td>
</tr>
</tbody>
</table>


</td>
</tr>
<tr>
<td>value</td>
<td>string</td>
<td>Current value of the account setting.</td>
</tr>
<tr>
<td>is_default</td>
<td>boolean</td>
<td>Indicates whether the account is using the system default value for the setting. Returns <code>true</code> when the account is using the system default and <code>false</code> when the account has a custom override.</td>
</tr>
</tbody>
</table>