List endpoint filter values

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.

cURL
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
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
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
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
{
    "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

Name Req/Opt Type Description
searchCriteriaList optional array Filter results by specified values.
.. key optional string Filter parameter.
Allowed values: cn, serialNumber, ip, port, scanName, serverSecurity, isCertPresent
.. operation optional string Filter operation.
Allowed value: STARTS_WITH
.. value optional array Filter values.
accountId required string Account ID.
divisionIds optional array Division IDs.
startIndex optional int Start at the specified index.
Default: 1
pageSize optional int Number of records per page.
Default: 50
filterSelected required string Data type you want to retrieve.
Allowed values: cn, serialNumber, ip, port, scanName, serverSecurity, isCertPresent
sortedColumnId optional string Sort results by specified parameter.
Allowed value: isCertPresent
sortOrder optional string Sort direction.
Allowed values: DESC (descending: 9-0, Z-A), ASC (ascending: 0-9, A-Z)
Default: DESC

Response parameters

Name Type Description
data object Container.
.. filterName string Specified filter ID.
.. displayName string Friendly filter name.
.. values array Matching results.