# Obtain Certificate - GetCertificateV2

## Overview

Get Certificate List (New)






## Definition

### Public Parameters

| Parameter Name | Type | Description Information | Required |
|:---|:---|:---|:---|
| **Action**     | string  | Corresponding API command name, the current API is `GetCertificateV2`.                      | **Yes** |
| **PublicKey**  | string  | The user's public key can be obtained from [Console](https://console.scloudsg.com/uaccount/api_manage)                                             | **Yes** |
| **Signature**  | string  | User signature generated based on public key and API command, see [Signature Algorithm](/docs/api/summary/signature.md)  | **Yes** |

### Request Parameters

| Parameter Name | Type | Description Information | Required |
|:---|:---|:---|:---|
| **ProjectId** | string | Project ID. If not filled in, the default project is used, sub-accounts must be filled in. Please refer to the [GetProjectList interface](/docs/api/summary/get_project_list). |No|
| **CdnDomain** | string | Filter the corresponding certificates according to the acceleration domain name. |No|
| **Offset** | int | Offset, default is 0, non-negative integer |No|
| **Limit** | int | Length, default is all, non-negative integer |No|

### Response Field

| Field Name | Type | Description Information | Required |
|:---|:---|:---|:---|
| **RetCode** | int | Return status code. If it is 0, it means successful return. If it is not 0, it means failure. |**Yes**|
| **Action** | string | Operation command name. |**Yes**|
| **Message** | string | Returns an error message, providing detailed description when `RetCode` is non-zero. |No|
| **TotalCount** | int | Certificate Quantity |**Yes**|
| **CertList** | array[[*CertList*](#certlist)] | Certificate Information List |**Yes**|

#### Data Model


#### CertList

| Field Name | Type | Description Information | Required |
|:---|:---|:---|:---|
| **CertName** | string | Certificate Name |**Yes**|
| **CommonName** | string | General Name |**Yes**|
| **DnsName** | string | DNS Name |**Yes**|
| **BeginTime** | int | Certificate Start Time |**Yes**|
| **EndTime** | int | Certificate Acquisition Time |**Yes**|
| **DomainCount** | int | Number of Configured Domains |**Yes**|
| **UserCert** | string | Certificate Content |**Yes**|
| **CaCert** | string | CA certificate content |**Yes**|
| **Domains** | array[string] | Configured Domain Name List |No|

## Example

### Request Example
    
```
https://api.scloudsg.com/?Action=GetCertificateV2
&ProjectId=GfZloUyO
&Offset=8
&Limit=6
&CdnDomain=oKNiSllO
```

### Response Example
    
```json
{
  "Action": "GetCertificateV2Response",
  "CertList": [
    {
      "BeginTime": 6,
      "CaCert": "dbvZSNyE",
      "CertName": "tGFFxvhj",
      "CommonName": "EfockrQK",
      "DnsName": "xjhMPWqV",
      "DomainCount": 8,
      "EndTime": 4,
      "UserCert": "rEAUBqQv"
    }
  ],
  "RetCode": 0,
  "TotalCount": 1
}
```