---
title: "Get key info"
source_url: https://dev.digicert.com/certcentral-apis/services-api/api-keys/get-key-info.html
api_method: GET
api_endpoint: "/services/v2/key/{{key_id}}"
api_url: "https://www.digicert.com/services/v2/key/{{key_id}}"
---

**GET** `https://www.digicert.com/services/v2/key/{{key_id}}`

Use this endpoint to get details about an API key.


> **Info**
>
> The API key itself will not be returned.


## Example requests and responses

**cURL**

```bash
curl -X GET \
  'https://www.digicert.com/services/v2/key/{{key_id}}' \
  -H 'Content-Type: application/xml' \
  -H 'X-DC-DEVKEY: {{api_key}}'
```

**Python**

```python
import requests

url = "https://www.digicert.com/services/v2/key/{{key_id}}"

headers = {
    'X-DC-DEVKEY': "{{api_key}}",
    'Content-Type': "application/xml"
    }

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/services/v2/key/{{key_id}}"

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

	req.Header.Add("X-DC-DEVKEY", "{{api_key}}")
	req.Header.Add("Content-Type", "application/xml")

	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/services/v2/key/{{key_id}}',
  headers: 
   { 'Content-Type': 'application/xml',
     'X-DC-DEVKEY': '{{api_key}}' } };

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

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


**200 OK (API key)**

```json
{
  "id": 184,
  "user": {
    "id": 125039,
    "first_name": "John",
    "last_name": "Smith"
  },
  "status": "active",
  "create_date": "2018-08-07T23:27:58+00:00",
  "last_used_date": "2018-08-18T19:08:19+00:00",
  "name": "Key Name",
  "is_legacy": false,
  "restricted_to_role_id": 0
}
```

**200 OK (ACME URL)**

```json
{
  "id": 15,
  "user": {
    "id": 10,
    "first_name": "Jill",
    "last_name": "Valentine"
  },
  "status": "active",
  "create_date": "2018-11-20T22:27:47+00:00",
  "name": "ACME URL Name",
  "is_legacy": false,
  "restricted_to_role_id": 0,
  "acme_directory_url": "******nnAA",
  "product_name_id": "ssl_plus",
  "product_name": "Standard SSL",
  "organization_id": 123456,
  "organization_name": "STARS",
  "validity_days": "0",
  "validity_years": "2"
}
```


## Response parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>int</td>
<td>Key ID.</td>
</tr>
<tr>
<td>user</td>
<td>object</td>
<td>Details about the user linked to the key.</td>
</tr>
<tr>
<td>.. id</td>
<td>int</td>
<td>User ID.</td>
</tr>
<tr>
<td>.. first_name</td>
<td>string</td>
<td>First name of user.</td>
</tr>
<tr>
<td>.. last_name</td>
<td>string</td>
<td>Last name of user.</td>
</tr>
<tr>
<td>status</td>
<td>string</td>
<td>Key status.<br>Possible values: active, revoked</td>
</tr>
<tr>
<td>create_date</td>
<td>string</td>
<td>Key creation timestamp.<br>Format: UTC timezone and ISO 8601 date</td>
</tr>
<tr>
<td>last_used_date</td>
<td>string</td>
<td>Timestamp of the last time the key was used.<br>Format: UTC timezone and ISO 8601 date</td>
</tr>
<tr>
<td>name</td>
<td>string</td>
<td>Name of the key.</td>
</tr>
<tr>
<td>is_legacy</td>
<td>bool</td>
<td>Legacy status of the key.</td>
</tr>
<tr>
<td>restricted_to_role_id</td>
<td>int</td>
<td>Access role ID that limits API key permissions to a defined set of actions. See Glossary – API key roles.</td>
</tr>
<tr>
<td>acme_directory_url</td>
<td>string</td>
<td>Obfuscated ACME directory URL. Only returned for ACME keys.</td>
</tr>
<tr>
<td>product_name_id</td>
<td>string</td>
<td>Name ID of the product ordered via ACME. Only returned for ACME keys. See Glossary – Product identifiers.</td>
</tr>
<tr>
<td>product_name</td>
<td>string</td>
<td>Friendly name of the product ordered via ACME. Only returned for ACME keys. See Glossary – Product identifiers.</td>
</tr>
<tr>
<td>organization_id</td>
<td>string</td>
<td>Organization name associated with certificate orders via ACME. Only returned for ACME keys.</td>
</tr>
<tr>
<td>organizatin_name</td>
<td>string</td>
<td>Organization name associated with certificate orders via ACME. Only returned for ACME keys.</td>
</tr>
<tr>
<td>validity_days</td>
<td>string</td>
<td>Number of days the certificate will be valid. Only returned for ACME keys.</td>
</tr>
<tr>
<td>validity_years</td>
<td>string</td>
<td>Number of years the certificate will be valid. Only returned for ACME keys.</td>
</tr>
</tbody>
</table>