Skip to main content

List domains

GET https://www.digicert.com/services/v2/domain

Use this endpoint to list all domains in your account.

Example requests and responses

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.

Name

Req/Opt

Type

Description

include_dcv_expiration_time

optional

boolean

Changes the format and timezone of DCV expiration values returned in the dcv_expiration object (ev, ov, ov_shortened, and dcv_approval_date).

If true, the dcv_expiration object returns DCV expiration values formatted as a UTC ISO-8601 string. Example: YYYY-MM-DDThh:mm:ss+00:00.

If false (default), the dcv_expiration object returns DCV expiration values in Mountain Time (MT) in YYYY-MM-DD format with no timestamp.

filters[{{property_name}}]

optional

string

Filters results by the specified property. Replace {{property_name}} in your request with the property to use for filtering. This endpoint supports the following filters:

  • filters[status]: Use active or inactive.

  • filters[validation]: Validation status for the domain. See Validation filter values.

  • filters[include_validation_reuse_status]: Use true to include the ov_shortened, ov_status, ev_status, and dcv_approval_date parameters in the dcv_expiration object in the response data. To exclude these parameters from the response, omit this filter or use false (default).

  • filters[dcv_method]: Filter by DCV method. Use email, dns-cname-token, dns-txt-token, http-token, or http-token-static.

filters[search]

optional

string

Limits response to results where the value of the name property matches or contains a specific string of characters.

To search for values that contain a specific string of characters, prefix the string with a URL encoded (percent-encoded) % character: %25. To search for values that are an exact match for a string of characters, omit the %25 from the request.

Examples:

  • filters[search]=%25example

    Limits response to results where the value of a searched property contains the string example.

  • filters[search]=example.com

    Limits response to results where the value of a searched property is an exact match for the string example.com.

sort

optional

string

Sorts results by the value of one or more properties. By default, sorts results in ascending alphabetical order (0-9, A-Z).

To sort in descending alphabetical order (9-0, Z-A), prefix the property name with a minus (-).

To sort by multiple properties, separate the name of each property with a comma. Sort hierarchy matches the order of properties in this list. This endpoint supports sorting by the following properties:

  • id

  • is_active

  • name

  • date_created

  • organization_id

  • organization_name

  • organization_status

  • organization_is_active

  • dcv_method

  • container_id

  • container_name

limit

optional

int

Total number of results to include in the response.

Max:1000 (default)

offset

optional

int

Index of the first result to include in the response.

Default:0

Response parameters

Name

Type

Description

domains

array

List of domains returned by request.

.. id

int

Domain ID.

.. is_active

bool

Active status of the domain.

.. name

string

Name of the domain.

.. dcv_approval_datetime

string

Completion date and time (UTC) of the most recent DCV check for the domain. Returned for all domains you have completed a DCV check for at least once.

Format: UTC timezone and ISO 8601 date

.. dcv_expiration_datetime

string

Expiration date and time (UTC) of the most recent DCV check for the domain. Returned for all domains you have completed a DCV check for at least once.

Format: UTC timezone and ISO 8601 date

.. last_submitted_datetime

string

Date and time (UTC) the domain was last submitted for DCV.

Format: UTC timezone and ISO 8601 date

Note: Only returned for domains submitted for validation or revalidation after March 3, 2022 .

.. date_created

string

Timestamp of when the domain was added.

Format: UTC timezone and ISO 8601 date

.. domain_locking_status

string

Domain lock status. Domain locking prevents users in other CertCentral accounts from requesting certificates for the domain.

A domain only returns the domain_locking_status property if domain locking is enabled for the account. See Domain locking – Enable domain locking for your account.

Possible values:

  • disabled: Domain lock disabled. Users in other CertCentral accounts can request certificates for the domain.

  • pending: Domain lock pending. To finish setting up domain locking, place the account token (account_token) on the DNS Certificate Authority Authorization (CAA) resource record for the domain (see Domain locking – Locking a domain, step 6). Then, submit a request to the Check CAA (domain lock) endpoint.

  • enabled: Domain lock enabled. Only users belonging to your CertCentral account can request certificates for the domain.

.. account_token

string

Account token to use for domain locking.

A domain only returns the account_token parameter if these conditions are met:

  • Domain locking is enabled for the account. See Domain locking – Enable domain locking for your account.

  • Domain locking has been activated for the domain at least once. If domain locking has never been activated, no token exists for the domain, and the domain object does not include an account_token parameter.

.. organization

object

Organization attached to the domain.

.. .. id

int

Organization ID.

.. .. status

string

Validation status of the organization.

.. .. name

string

Legal name of the organization.

.. .. assumed_name

string

Public name of the organization. Also called DBA name.

.. .. display_name

string

Full name of the organization. Constructed using name + assumed_name.

.. is_active

string

Active status of the organization.

.. validations

array

List of validation details for the domain.

To see the structure of data objects in the validations array, see Structures – Validations object.

Note: For each domain, the List domains endpoint only returns validations with an active status. If a domain has no active validations, we do not return the validations array for that domain. To see all of the validations for a domain (including pending and expired validations), use the Domain info endpoint.

.. dcv_method

string

Domain control validation method configured for the domain. See Glossary – DCV methods.

.. dcv_expiration

string

If DCV is completed, this object is returned with information about when OV and EV domain validations expire.

.. .. ev

string

Expiration date for EV domain validation.

Format:

  • Default: YYYY-MM-DD (Mountain Time)

  • If URL includes include_dcv_expiration_time=true: YYYY-MM-DDThh:mm:ss+00:00 (UTC)

.. .. ov

string

Expiration date for OV domain validation.

Format:

  • Default: YYYY-MM-DD (Mountain Time)

  • If URL includes include_dcv_expiration_time=true: YYYY-MM-DDThh:mm:ss+00:00 (UTC)

Note: On September 27, 2021, the expiration date for existing OV domain validations will shorten to 397 days from the date validation was completed. Learn more about this policy change: Domain validation changes in 2021.

.. .. ov_shortened

string

New expiration date for OV domain validation after industry changes to shorten the domain validation reuse period go into effect on September 27, 2021. Only returned if the request URL includes the query string filters[include_validation_reuse_status]=true.

Format:

  • Default: YYYY-MM-DD (Mountain Time)

  • If URL includes include_dcv_expiration_time=true: YYYY-MM-DDThh:mm:ss+00:00 (UTC)

Note: After September 27, 2021, the dcv_expiration.ov_shortened parameter will return the same date as the dcv_expiration.ov parameter. Learn more about this policy change: Domain validation changes in 2021.

.. .. ov_status

string

OV domain validation status. Only returned if request URL includes the query string filters[include_validation_reuse_status]=true.

Possible values:

  • expired: OV domain validation is expired.

  • expiring_soon: OV domain validation expires in the next 60 days.

  • valid: OV domain validation is valid.

  • industry_shortened_expired: On September 27, 2021, OV domain validation will be reduced. The reduced validation period will be expired.

  • industry_shortened_expiring_soon: On September 27, 2021, OV domain validation will be reduced. The reduced validation period will expire before December 1, 2021.

Note: After September 27, 2021, the ov_status parameter will stop returning industry_shortened_expired and industry_shortened_expiring_soon values. Learn more about this policy change: Domain validation changes in 2021.

.. .. ev_status

string

EV domain validation status. Only returned if request URL includes the query string filters[include_validation_reuse_status]=true

Possible values:

  • expired: EV domain validation is expired.

  • expiring_soon: EV domain validation expires in the next 60 days.

  • valid: EV domain validation is valid.

.. .. dcv_approval_date

string

Date of the most recent DCV approval for the domain. Only returned if the request URL includes the query string filters[include_validation_reuse_status]=true.

Format:

  • Default: YYYY-MM-DD (Mountain Time)

  • If URL includes include_dcv_expiration_time=true: YYYY-MM-DDThh:mm:ss+00:00 (UTC)

.. container

object

Container the domain is attached to.

.. .. id

int

Container ID.

.. .. parent_id

int

ID of the container's parent.

.. .. name

string

Name of the container.

.. .. is_active

bool

Active status of the container.

.. base_domain

string

Base domain of the domain name. For example, if the domain name is sub.example.com, the base_domain is example.com.

Note: If the domain name is an IP address, the base_domain is also the IP address.

page

object

Details about results. Modified using URL query strings.

Validation filter values

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

Name

Description

completed

Domain validation is complete. Only includes domains with an active OV or EV domain validation status.

ov_expired

OV domain validation is expired.

ev_expired

EV domain validation is expired.

ov_expiring

OV domain validation expires in the next 30 days.

ev_expiring

EV domain validation expires in the next 30 days.

shortened_by_industry_changes

On September 27, 2021, OV validation for the domain will be reduced. The reduced validation period will have expired or will expire before December 1, 2021.

Note: After September 27, the shortened_by_industry_changes filter value will be ignored. On September 27, 2021, DigiCert shortens the domain validation reuse period for OV certificates to 397 days. Learn more about this policy change: Domain validation changes in 2021.

ov_expired_in_last_7_days

OV domain validation expired between 7 days ago (inclusive) and today (exclusive).

ov_expiring_within_7_days

OV domain validation expires in the next 0 (inclusive) to 7 (inclusive) days.

ov_expiring_within_30_days

OV domain validation expires in the next 0 (inclusive) to 30 (inclusive) days.

ov_expiring_from_31_to_60_days

OV domain validation expires in the next 31 (inclusive) to 60 (inclusive) days.

ov_expiring_from_61_to_90_days

OV domain validation expires in the next 61 (inclusive) to 90 (inclusive) days.

ev_expired_in_last_7_days

EV domain validation expired between 7 days ago (inclusive) and today (exclusive).

ev_expiring_within_7_days

EV domain validation expires in the next 0 (inclusive) to 7 (inclusive) days.

ev_expiring_within_30_days

EV domain validation expires in the next 0 (inclusive) to 30 (inclusive) days.

ev_expiring_from_31_to_60_days

EV domain validation expires in the next 31 (inclusive) to 60 (inclusive) days.

ev_expiring_from_61_to_90_days

EV domain validation expires in the next 61 (inclusive) to 90 (inclusive) days.