List endpoint filter values

3 minute read

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 -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"
}'

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)

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))

}

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`, Max: `100`
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`