---
title: "List endpoint filter values"
source_url: https://dev.digicert.com/certcentral-apis/discovery-api/certificates/list-endpoint-filter-values.html
api_method: POST
api_endpoint: "/apicontroller/v1/reports/filter"
api_url: "https://daas.digicert.com/apicontroller/v1/reports/filter"
---

**POST** `https://daas.digicert.com/apicontroller/v1/reports/filter`

Get all known values for server attributes found through CertCentral Discovery scans. For example, get all scan names that performed scans or get IP addresses found through Discovery scans.

Known values allow you to populate valid information for end users to choose, instead of users needing to know exact values beforehand.

## Example requests and responses

**cURL**

```bash
curl -X POST \
  https://daas.digicert.com/apicontroller/v1/reports/filter \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
    "searchCriteriaList": [
        {
            "key":"cn",
            "operation": "STARTS_WITH",
            "value": [
                "www","digi"
            ]
        }
     ],
    "accountId": "126993",
    "divisionIds": [],
    "startIndex": 1,
    "pageSize": 50,
    "filterSelected": "ip",
    "sortedColumnId": null,
    "sortOrder": "ASC"
}'
```

**Python**

```python
import requests

url = "https://daas.digicert.com/apicontroller/v1/reports/filter"

payload = "{\n    \"searchCriteriaList\": [\n        {\n            \"key\": \"cn\",\n            \"operation\": \"STARTS_WITH\",\n            \"value\": [\n                \"www\",\"digi\"\n            ]\n        }\n    ],\n    \"accountId\": \"126993\",\n    \"divisionIds\": [],\n    \"startIndex\": 1,\n    \"pageSize\": 50,\n    \"filterSelected\": \"ip\",\n    \"sortedColumnId\": null,\n    \"sortOrder\": \"ASC\"\n}"
headers = {
    'X-DC-DEVKEY': "{{api_key}}",
    'Content-Type': "application/json",
    }

response = requests.request("POST", url, data=payload, headers=headers)

print(response.text)
```

**Go**

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://daas.digicert.com/apicontroller/v1/reports/filter"

	payload := strings.NewReader("{\n    \"searchCriteriaList\": [\n        {\n            \"key\": \"cn\",\n            \"operation\": \"STARTS_WITH\",\n            \"value\": [\n                \"www\",\"digi\"\n            ]\n        }\n    ],\n    \"accountId\": \"126993\",\n    \"divisionIds\": [],\n    \"startIndex\": 1,\n    \"pageSize\": 50,\n    \"filterSelected\": \"ip\",\n    \"sortedColumnId\": null,\n    \"sortOrder\": \"ASC\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

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

	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: 'POST',
  url: 'https://daas.digicert.com/apicontroller/v1/reports/filter',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' },
  body: 
   { searchCriteriaList: 
      [ { key: 'cn', operation: 'STARTS_WITH', value: [ 'www','digi' ] } ],
     accountId: '126993',
     divisionIds: [],
     startIndex: 1,
     pageSize: 50,
     filterSelected: 'ip',
     sortedColumnId: null,
     sortOrder: 'ASC' },
  json: true };

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

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


## 200 OK

```json
{
    "data": {
        "filterName": "ip",
        "displayName": "ip",
        "values": [
            "103.23.108.107",
            "104.154.127.47",
            "104.19.194.29",
            "104.19.195.29",
            "104.199.240.211",
            "104.199.64.136",
            "104.215.148.63",
            "104.236.66.94",
            "104.244.42.1",
            "104.244.42.129",
            "104.244.42.133",
            "104.244.42.193",
            "104.244.42.197",
            "106.11.186.1",
            "106.11.186.25",
            "106.120.159.68",
            "107.150.101.156",
            "107.23.104.215",
            "108.174.10.10",
            "109.71.161.200",
            "110.75.129.5",
            "110.75.139.5",
            "111.161.64.40",
            "111.161.64.48",
            "121.42.17.238",
            "121.42.17.239",
            "123.125.114.144",
            "123.125.116.28",
            "123.126.157.222",
            "123.126.55.41",
            "125.209.222.141",
            "125.209.222.142",
            "13.107.21.200",
            "13.225.214.41",
            "13.35.78.123",
            "13.35.78.38",
            "13.35.78.43",
            "13.35.78.87"
        ]
    }
}
```

## Request 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>searchCriteriaList</td>
<td>optional</td>
<td>array</td>
<td>Filter results by specified values.</td>
</tr>
<tr>
<td>.. key</td>
<td>optional</td>
<td>string</td>
<td>Filter parameter.<br><strong>Allowed values:</strong> <code>cn</code>, <code>serialNumber</code>, <code>ip</code>, <code>port</code>, <code>scanName</code>, <code>serverSecurity</code>, <code>isCertPresent</code></td>
</tr>
<tr>
<td>.. operation</td>
<td>optional</td>
<td>string</td>
<td>Filter operation.<br><strong>Allowed value:</strong> <code>STARTS_WITH</code></td>
</tr>
<tr>
<td>.. value</td>
<td>optional</td>
<td>array</td>
<td>Filter values.</td>
</tr>
<tr>
<td>accountId</td>
<td>required</td>
<td>string</td>
<td>Account ID.</td>
</tr>
<tr>
<td>divisionIds</td>
<td>optional</td>
<td>array</td>
<td>Division IDs.</td>
</tr>
<tr>
<td>startIndex</td>
<td>optional</td>
<td>int</td>
<td>Start at the specified index.<br><strong>Default:</strong> <code>1</code></td>
</tr>
<tr>
<td>pageSize</td>
<td>optional</td>
<td>int</td>
<td>Number of records per page.<br><strong>Default:</strong> <code>50</code>,<br><strong>Max:</strong> <code>100</code></td>
</tr>
<tr>
<td>filterSelected</td>
<td>required</td>
<td>string</td>
<td>Data type you want to retrieve.<br><strong>Allowed values:</strong> <code>cn</code>, <code>serialNumber</code>, <code>ip</code>, <code>port</code>, <code>scanName</code>, <code>serverSecurity</code>, <code>isCertPresent</code></td>
</tr>
<tr>
<td>sortedColumnId</td>
<td>optional</td>
<td>string</td>
<td>Sort results by specified parameter.<br><strong>Allowed value:</strong> <code>isCertPresent</code></td>
</tr>
<tr>
<td>sortOrder</td>
<td>optional</td>
<td>string</td>
<td>Sort direction.<br><strong>Allowed values:</strong> <code>DESC</code> (descending: 9-0, Z-A), <code>ASC</code> (ascending: 0-9, A-Z)<br><strong>Default:</strong> <code>DESC</code></td>
</tr>
</tbody>
</table>

## Response parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>data</td>
<td>object</td>
<td>Container.</td>
</tr>
<tr>
<td>.. filterName</td>
<td>string</td>
<td>Specified filter ID.</td>
</tr>
<tr>
<td>.. displayName</td>
<td>string</td>
<td>Friendly filter name.</td>
</tr>
<tr>
<td>.. values</td>
<td>array</td>
<td>Matching results.</td>
</tr>
</tbody>
</table>