List domains

Example requests and responses

• cURL
• Python
• Go
• NodeJS

curl -X GET \
  'https://www.digicert.com/services/v2/domain' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}'

import requests

url = "https://www.digicert.com/services/v2/domain"

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

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

print(response.text.encode('utf8'))

package main

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

func main() {

		url := "https://www.digicert.com/services/v2/domain"
		method := "GET"

		client := &http.Client {
		}
		req, err := http.NewRequest(method, url, nil)

		if err != nil {
				fmt.Println(err)
		}
		req.Header.Add("X-DC-DEVKEY", "{{api_key}}")
		req.Header.Add("Content-Type", "application/json")

		res, err := client.Do(req)
		defer res.Body.Close()
		body, err := ioutil.ReadAll(res.Body)

		fmt.Println(string(body))
}

var request = require("request");

var options = {
  method: 'GET',
  url: 'https://www.digicert.com/services/v2/domain',
  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 (include_validation_reuse_status = true)

{
  "domains": [
    {
      "id": 12345,
      "is_active": true,
      "name": "example.org",
      "date_created": "2022-02-10T15:24:08+00:00",
      "last_submitted_datetime": "2022-02-28T08:03:06+00:00",
      "dcv_approval_datetime": "2022-02-24T06:49:33+00:00",
      "organization": {
        "id": 1560288,
        "status": "active",
        "name": "Example Org",
        "display_name": "Example Org",
        "is_active": "1"
      },
      "validations": [
        {
          "type": "ev",
          "name": "EV",
          "description": "Extended Organization Validation (EV)",
          "date_created": "2022-02-24T06:49:33+00:00",
          "validated_until": "2023-03-27T06:00:00+00:00",
          "status": "active"
        },
        {
          "type": "ov",
          "name": "OV",
          "description": "Normal Organization Validation",
          "date_created": "2022-02-24T06:49:33+00:00",
          "validated_until": "2023-03-27T06:00:00+00:00",
          "status": "active"
        }
      ],
      "dcv_method": "email",
      "dcv_expiration": {
        "ev": "2023-03-27",
        "ov": "2023-03-27",
        "ov_shortened": "2023-03-27",
        "ov_status": "valid",
        "ev_status": "valid",
        "dcv_approval_date": "2022-02-23"
      },
      "container": {
        "id": 677797,
        "name": "Example Division"
      },
      "base_domain": "example.org",
      "dcv_approval_method": "dns-txt-token"
    }
  ],
  "page": {
    "total": 1,
    "limit": 1000,
    "offset": 0
  }
}

Filters and URL query parameters

This endpoint supports filters, sorting, and pagination. For general information and examples of the syntax to use when applying filters and sorting results, see Services API - Filters, sorting, and pagination parameters.

Response parameters

Validation filter values

This table shows allowed values for the filters[validation] URL query string.