---
title: "ListAdvancedCertificates"
slug: "security-certificatemanager-listadvancedcertificates"
updated: 2026-09-17T09:16:56Z
published: 2026-09-17T09:16:56Z
canonical: "api.ncloud-docs.com/security-certificatemanager-listadvancedcertificates"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ListAdvancedCertificates

Classic/VPC 환경에서 이용 가능합니다.

보유 중인 Advanced DV, Advanced OV 인증서를 조회합니다.

## 요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

| 메서드 | URI |
| --- | --- |
| GET | /api/v2/certificate/getPaidCertificates |

### 요청 헤더

Certificate Manager API에서 공통으로 사용하는 헤더에 대한 정보는 [Certificate Manager 요청 헤더](/docs/security-certificatemanager#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)를 참조해 주십시오.

### 요청 쿼리 파라미터

요청 쿼리 파라미터에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `page` | Integer | Optional | 페이지 번호 |
| `pageSize` | Integer | Optional | 페이지당 항목 수 |
| `certificateName` | String | Optional | 인증서 이름으로 결과 제한 |

### 요청 예시

요청 예시는 다음과 같습니다.

```
curl --location --request GET 'https://certificatemanager.apigw.ntruss.com/api/v2/certificate/getPaidCertificates' \
--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'
```

## 응답

응답 형식을 설명합니다.

### 응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `returnCode` | String | - | 응답 코드 |
| `returnMessage` | String | - | 응답 메시지 |
| `totalCount` | Integer | - | 조회된 목록의 총 개수 |
| `orders` | Array | - | 인증서 발급 요청 목록: [orders](/docs/security-certificatemanager-listadvancedcertificates#orders) |

#### `orders`

`orders`에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `orderId` | String | - | 인증서 발급 요청 아이디 |
| `certificates` | Array | - | 인증서 목록: [certificates](/docs/security-certificatemanager-listadvancedcertificates#certificates) |

#### `certificates`

`certificates`에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `certificateNo` | Integer | - | 인증서 번호 |
| `certificateName` | String | - | 인증서 이름 |
| `memberNo` | String | - | 네이버 클라우드 플랫폼 사용자 회원 번호 |
| `commonName` | String | - | 인증서 CN(Common Name)에 포함될 도메인 |
| `dnsName` | String | - | 인증서 SAN(Subject Alternative Name)에 포함될 도메인 목록 |
| `statusCode` | String | - | 인증서 상태 코드 - `0` \| `1` \| `2` \| `3` \| `-1` \| `-2` \| `-3` \| `-4` \| `-5` \| `-6` \| `-7` \| `-11` \| `-12` \| `-20` - `0`: ONGOING - `1`: NORMAL - `2`: NORMAL_UNREGISTERED_PRIVATE_KEY - `3`: NORMAL_GLOBAL_EDGE_DEDICATED - `-1`: FAILED - `-2`: EXPIRE - `-3`: VALIDATION_FAILED - `-4`: VALIDATION_EXPIRE - `-5`: REVOKE - `-6`: DELETED - `-7`: REQUEST_REVOKE - `-11`: FAILED (LINT) - `-12`: FAILED (CT) - `-20`: FAILED (ORG_LOCK / DNS_TXT) |
| `statusName` | String | - | 인증서 상태 - `ONGOING` \| `NORMAL` \| `NORMAL_UNREGISTERED_PRIVATE_KEY` \| `NORMAL_GLOBAL_EDGE_DEDICATED` \| `FAILED` \| `EXPIRE` \| `VALIDATION_FAILED` \| `VALIDATION_EXPIRE` \| `REVOKE` \| `DELETED` \| `REQUEST_REVOKE` - `ONGOING`: 진행 중 - `NORMAL`: 정상 - `NORMAL_UNREGISTERED_PRIVATE_KEY`: 정상 (개인 키 미등록) - `NORMAL_GLOBAL_EDGE_DEDICATED`: 정상 (Global Edge Dedicated) - `FAILED`: 실패 - `FAILED (LINT)`: 실패 (LINT 체크) - `FAILED (CT)`: 실패 (CT 체크) - `FAILED (ORG_LOCK / DNS_TXT)`: 조직 정보 불일치 (DNS TXT) - `EXPIRE`: 기간 만료 - `VALIDATION_FAILED`: 검증 실패 - `VALIDATION_EXPIRE`: 검증 시간 초과 - `REVOKE`: 폐기 - `DELETED`: 삭제 - `REQUEST_REVOKE`: 폐기 중 |
| `certificateType` | String | - | 인증서 타입 - `NCP_PAID_DV_01` \| `NCP_PAID_OV_01` - `NCP_PAID_DV_01`: Advanced DV 인증서 - `NCP_PAID_OV_01`: Advanced OV 인증서 |
| `domainCode` | String | - | 발급 기반 도메인 - `PUB`: 네이버 클라우드 플랫폼(개인/일반 기업용) |
| `updateDate` | String | - | 최근 변경 일시 - yyyy-MM-dd HH:mm:ss(UTC+09:00) 형식 |
| `issueType` | String | - | 발급 상태: 해당 인증서를 이용하여 재발급 가능 여부를 확인하기 위해 사용 - `ORIGINAL` \| `REPRESENTATIVE` \| `REISSUE` - `ORIGINAL`: 원본 인증서 (대표 인증서가 없을 경우에 재발급 가능) - `REPRESENTATIVE`: 대표 인증서 (재발급 가능) - `REISSUE`: 재발급 인증서 (재발급 불가) |
| `subjectDN` | String | - | 인증서 DN(Distinguished Name) 정보 |
| `registDate` | String | - | 인증서 등록 일시 - yyyy-MM-dd HH:mm:ss(UTC+09:00) 형식 |
| `notAfter` | String | - | 인증서 만료 일시 - yyyy-MM-dd HH:mm:ss(UTC+09:00) 형식 |
| `notBefore` | String | - | 인증서 유효 시작 일시 - yyyy-MM-dd HH:mm:ss(UTC+09:00) 형식 |
| `issueDate` | String | - | 인증서 발급 일시 - yyyy-MM-dd HH:mm:ss(UTC+09:00) 형식 |
| `revokeDate` | String | - | 인증서 폐지 일시 - 인증서가 폐지된 경우에만 표시 |
| `issuer` | String | - | 인증서 발급 기관(CA) 이름 |
| `serialNumber` | String | - | 인증서 일련 번호 |
| `signatureAlgorithm` | String | - | 서명 알고리즘 |
| `certPublicKeyInfo` | String | - | 공개 키(Public key) 정보 |
| `orderId` | String | - | 인증서 발급 요청 아이디 |
| `usedInstanceNoList` | String | - | 인증서를 사용 중인 인스턴스 목록 - 사용 중인 인스턴스가 없는 경우 값 없음 |

### 응답 상태 코드

Certificate Manager API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 [Certificate Manager 응답 상태 코드](/docs/security-certificatemanager#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)를 참조해 주십시오.

### 응답 예시

응답 예시는 다음과 같습니다.

```
{
  "returnCode": "0",
  "returnMessage": "Success",
  "totalCount": 1,
  "orders": [
    {
      "orderId": "900001",
      "certificates": [
        {
          "certificateNo": 100001,
          "certificateName": "sample-cert-01",
          "memberNo": "9999999",
          "commonName": "example.com",
          "statusCode": "0",
          "statusName": "Ongoing",
          "certificateType": "NCP_PAID_OV_01",
          "domainCode": "PUB",
          "updateDate": "2026-03-01 10:15:30(UTC+09:00)",
          "orderId": "900001",
          "issueType": "ORIGINAL",
          "subjectDN": "cn=example.com,o=Example Corporation,l=Sample-city,s=Sample-state,c=KR",
          "registDate": "2026-03-01 10:15:30(UTC+09:00)",
          "notAfter": "2027-03-01 23:59:59(UTC+09:00)"
        }
      ]
    }
  ]
}
```