List certificate filter values

3 minute read

POST https://daas.digicert.com/apicontroller/v1/certificate/filter

Get all known values for certificate attributes found through CertCentral Discovery scans. For example, get all common names found through Discovery scans or get the certificate statuses currently applicable in your environment.

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

Example requests and responses

curl -X POST \
  https://daas.digicert.com/apicontroller/v1/certificate/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": "cn",
    "sortedColumnId": "cn",
    "sortOrder": "ASC"
}'

import requests

url = "https://daas.digicert.com/apicontroller/v1/certificate/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\": \"cn\",\n    \"sortedColumnId\": \"cn\",\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/certificate/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\": \"cn\",\n    \"sortedColumnId\": \"cn\",\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/certificate/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: 'cn',
     sortedColumnId: 'cn',
     sortOrder: 'ASC' },
  json: true };

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

  console.log(body);
});

200 OK

{
    "data": {
        "filterName": "cn",
        "displayName": "cn",
        "values": [
            "*.1688.com",
            "*.3.cn",
            "*.360buy.com",
            "*.360buyimg.com",
            "*.3c.tmall.com",
            "*.3g.youku.com",
            "*.51xiancheng.com",
            "*.7fresh.com",
            "*.91.com",
            "*.99ptoimg.com",
            "*.aa.peg.a2z.com",
            "*.ab.peg.a2z.com",
            "*.abird.youku.com",
            "*.ac.peg.a2z.com",
            "*.ac.youku.com",
            "*.account.sogo.com",
            "*.account.sogou.com",
            "*.account.youku.com",
            "*.activity-partner.youku.com",
            "*.activity.youku.com",
            "*.ad.youku.com",
            "*.adbox.sina.com.cn",
            "*.add.youku.com",
            "*.addmp.jobserver.youku.com",
            "*.admin.yelp.com",
            "*.admin.youku.com",
            "*.adplat.youku.com",
            "*.ads.nicovideo.jp",
            "*.aipage.cn",
            "*.aipage.com",
            "*.alibaba.com",
            "*.aliexpress.com",
            "*.aliqin.tmall.com",
            "*.alisports.youku.com",
            "*.alitrip.com",
            "*.aliyun.com",
            "*.amp.yimg.com",
            "*.ane.yahoo.co.jp",
            "*.aparat.com",
            "*.api.3g.cp31.ott.cibntv.net",
            "*.api.3g.tudou.com",
            "*.api.3g.youku.com",
            "*.api.bing.com",
            "*.api.bing.net",
            "*.api.community.youku.com",
            "*.api.espn.com",
            "*.api.kids.youku.com",
            "*.api.lite.tudou.com",
            "*.api.mobile.youku.com",
            "*.api.ott.youku.com"
        ]
    }
}

Request parameters

Name	Req/Opt	Type	Description
searchCriteriaList	optional	array	Filter results by specified values.
.. key	optional	string	Filter parameter. Allowed values: `cn`, `org`, `status`, `serialNum`, `securityRating`, `ca`
.. 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`, `org`, `status`, `serialNumber`, `securityRating`, `ca`
sortOrder	optional	string	Sort direction. Allowed values: `ASC` (ascending: 0-9, A-Z), `DESC` (descending: 9-0, Z-A) Default: `ASC`