ListDomainValidations

Available in Classic and VPC

Get the list of validation information for a registered domain.

Request

This section describes the request format. The method and URI are as follows:

Method	URI
GET	/api/v2/domain/domains

Request headers

For information about the headers common to all Certificate Manager APIs, see Certificate Manager request headers.

Request query parameters

You can use the following query parameters with your request:

Field	Type	Required	Description
`page`	Integer	Optional	Page number Default: 1
`pageSize`	Integer	Optional	Page size Default: 10
`domainAddress`	String	Optional	Domain address
`dcvType`	String	Optional	Domain validation (DCV) type `PTXT` \| `TXT` `PTXT`: Once configured, verification remains active without the need for subsequent record changes. `TXT`: A new record must be set each time a certificate is issued, and revalidation is required when the validity period expires.
`orgNo`	Integer	Optional	Organization number
`validState`	String	Optional	Validation status `PENDING` \| `VALID` \| `INVALID` `PENDING`: Validation pending `VALID`: Validation completed `INVALID`: Validation failed

Request example

The request example is as follows:

curl --location --request GET 'https://certificatemanager.apigw.ntruss.com/api/v2/domain/domains?page=1&pageSize=10' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'Content-Type: application/json' \
--header 'accept: application/json'

Response

This section describes the response format.

Response body

The response body includes the following data:

Field	Type	Required	Description
`returnCode`	String	-	Response code Success: `0` Failure: `1` or higher
`returnMessage`	String	-	Response message
`totalRows`	Integer	-	Total number of lists searched
`domainVldList`	Array	-	Domain validation information list: domainVldList

`domainVldList`

The following describes domainVldList.

Field	Type	Required	Description
`dmnId`	Long	-	Domain ID
`memberNo`	String	-	Member number
`domainAddress`	String	-	Domain address
`dcvType`	String	-	Domain validation (DCV) type `PTXT` \| `TXT`
`validState`	String	-	Validation status `VALID` \| `FAILED` \| `PENDING` \| `EXPIRED` `VALID`: Validation completed `FAILED`: Validation failed `PENDING`: Validation pending `EXPIRED`: Validation expired
`issueType`	String	-	Issuance type `CONSOLE` \| `ACME`
`orgNo`	Integer	-	Organization number
`validYn`	String	-	Validation status `Y` \| `N`
`validDate`	DateTime	-	Validation date
`createdDate`	DateTime	-	Creation date and time
`expireDate`	DateTime	-	Expiration date and time

Response status codes

For information about the HTTP status codes common to all Certificate Manager APIs, see Certificate Manager response status codes.

Response example

The response example is as follows:

{
    "returnCode": "0",
    "returnMessage": "Success",
    "totalRows": 9,
    "domainVldList": [
        {
            "dmnId": 573,
            "memberNo": "5000816",
            "domainAddress": "test.ncp-cm.com",
            "dcvType": "PTXT",
            "validState": "PENDING",
            "issueType": "CONSOLE",
            "acmeAccountId": null,
            "orgNo": null,
            "persistUntil": null,
            "validYn": "N",
            "validDate": null,
            "createdDate": "2026-04-16T17:11:20",
            "expireDate": "2026-04-25T17:11:20"
        }
    ]
}