---
title: "Retrieve API key"
source_url: https://dev.digicert.com/partner-subscriptions-api/api-key-management/retrieve-api-key.html
api_method: GET
api_endpoint: "/partner-subscription/api/v1/api-key/<apiKeyId>"
api_url: "https://www.digicert.com/partner-subscription/api/v1/api-key/{{apiKeyId}}"
---

**GET** `https://www.digicert.com/partner-subscription/api/v1/api-key/{{apiKeyId}}`

Use this endpoint to retrieve the details of a specific API key using its unique ID.


> **Info**
>
> Parent accounts can retrieve their own API keys and API keys that belong to their subaccounts. Subaccounts can retrieve only their own API keys. If the API key belongs to an unrelated account, the endpoint returns <code>403 Forbidden</code> error message.


## Example requests and responses

**cURL**

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

**Python**

```python
import requests

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

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/api-key/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/api-key/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

```json
{
  "id": 12345,
  "name": "Production API Key",
  "account_id": 67890,
  "status": "active",
  "created_at": "2025-01-15T10:30:00Z",
  "last_used_date": "2025-01-28T14:22:00Z",
  "api_key_last4": "xyz9"
}
```

## 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>apiKeyId</td>
<td>required</td>
<td>integer</td>
<td>The unique identifier of the API key.</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>id</td>
<td>integer</td>
<td>Unique identifier of the API key.</td>
</tr>
<tr>
<td>name</td>
<td>string</td>
<td>Descriptive name of the API key.</td>
</tr>
<tr>
<td>account_id</td>
<td>integer</td>
<td>Identifier of the account that owns the API key.</td>
</tr>
<tr>
<td>status</td>
<td>string</td>
<td>Operational status of the API key.<br>Allowed values: <code>active</code>, <code>inactive</code></td>
</tr>
<tr>
<td>created_at</td>
<td>string</td>
<td>API key creation date in ISO 8601 format.</td>
</tr>
<tr>
<td>last_used_date</td>
<td>string</td>
<td>Date and time the API key was last used.</td>
</tr>
<tr>
<td>api_key_last4</td>
<td>string</td>
<td>Last four characters of the API key.</td>
</tr>
</tbody>
</table>