Get whitelisted issuing CA brand details

GET
https://www.digicert.com/services/v2/ctmonitor/issuer-brand-settings?offset=0&limit=1000

Use this endpoint to get the details about a whitelisted certificate authority brand.

Example requests and response

cURL
curl -X GET \
  'https://www.digicert.com/services/v2/ctmonitor/issuer-brand-settings?filters[issuer_brand]=&sort=issuer_brand&offset=0&limit=25' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}'
Python
import requests

url = "https://www.digicert.com/services/v2/ctmonitor/issuer-brand-settings?offset=0&limit=1000"

payload = ""
headers = {
    'X-DC-DEVKEY': "{{api_key}}",
    'Content-Type': "application/json"
    }

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

print(response.text)
Go
package main

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

func main() {

	url := "https://www.digicert.com/services/v2/ctmonitor/issuer-brand-settings?filters[issuer_brand]=&sort=issuer_brand&offset=0&limit=25"

	req, _ := http.NewRequest("GET", url, nil)

	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: 'GET',
  url: 'https://www.digicert.com/services/v2/ctmonitor/issuer-brand-settings?filters[issuer_brand]=&sort=issuer_brand&offset=0&limit=25',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' } };

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

  console.log(body);
});
200 OK
{
       "ct_issuer_brand_settings": [
        {
            "issuer_brand": "Let's Encrypt",
            "certificates_count": 48,
            "disable_email_notification_flag": false,
            "trusted_ica_flag": false
        },
        {
            "issuer_brand": "Sectigo",
            "certificates_count": 7,
            "disable_email_notification_flag": false,
            "trusted_ica_flag": false
        },
        {
            "issuer_brand": "DigiCert",
            "certificates_count": 1,
            "disable_email_notification_flag": false
        }
    ],
    "page": {
        "total": 3,
        "limit": 25,
        "offset": 0
    }
}

Request filters and URL query strings

Filters and URL query strings are appended to the endpoint URL using ?. Multiple filters and URL query strings can be appended to the request using &.

For example:

markup
https://www.digicert.com/services/v2/ctmonitor/issuer-brand-settings?filters[issuer_brand]=&sort=issuer_brand&offset=0&limit=25
Name Req/Opt Type Description
issuer_brand optional string Brand name of certificate authority that issued the certificate.
sort optional string Sort results by specified parameter.
Possible values:
  • issuer_brand (default)
  • certificates_count
+ OR - optional Sort results in specified direction.
Possible values:
  • + (ascending)
  • (descending)
offset required int Start list at the specified number for pagination.
Default: 0
limit required int Truncate list to the specified number for pagination.
Max: 1000 (default)

Response parameters

Name Type Description
ct_issuer_brand_settings array Details about the whitelisted issuing certificate authority brand
.. issuer_brand string Name of certificate authority brand.
.. certificates_count string Total number of certificates for certificate authority brand.
.. disable_email_notification_flag bool If urgent email notifications for a certificate authority are enabled.
Possible values:
  • false: urgent emails are enabled
  • true: urgent emails are disabled
.. trusted_ica_flag bool If the certificate authority brand is whitelisted.
Possible values:
  • false: brand is not whitelisted
  • true: brand is whitelisted
page object Details about results. Modified using URL query strings.
.. total int Total number of records.
.. limit int Pagination record limit.
.. offset int Pagination starting point.