---
title: "GET a page of certificates for a specific domain product"
method: GET
path: "/v2/certificates/subscription/{guid}"
tags: ["v2"]
---

# GET a page of certificates for a specific domain product

`GET /v2/certificates/subscription/{guid}`

## Path parameters

- `guid` string, required

## Query parameters

- `pageSize` integer
- `page` integer
- `domain` string
- `status` 'ANY' | 'ACTIVE' | 'DENIED' | 'EXPIRED' | 'PENDING' | 'REVOKED'
- `type` 'ANY' | 'SINGLE' | 'UCC' | 'WILDCARD'
- `validation` 'ANY' | 'DV' | 'EV' | 'OV'

## Response `200`

OK

- CertificatesByDomainPaged
  - `allowedDomains` Domain[], required — The domains that are currently allowed on this subscription.
  - `domain` string, required — A domain, subject alternative name, or alias.
  - `guid` string, required — A Globally Unique Identifier
  - `maxDomains` integer, required — The maximum number of domains allowed on this subscription.
  - `subscriptionEndDate` string, date-time, required
  - `subscriptionStartDate` string, date-time, required
  - `subscriptionStatus` 'ACTIVE' | 'SUSPENDED' | 'CANCELED', required — The internal representation of the subscription. A reflection of the entitlement status.
  - `currentPage` integer, required — The page number.
  - `data` CertificateDetails[], required
    - `certificateId` string, required
    - `completionDate` string, date-time
    - `domain` string, required — A domain, subject alternative name, or alias.
    - `period` integer, required
    - `requestDate` string, date-time, required
    - `revocationDate` string, date-time
    - `sans` Domain[] — This includes the common-name
    - `serialNumber` string
    - `slotSize` integer
    - `status` 'ACTIVE' | 'DENIED' | 'EXPIRED' | 'PENDING' | 'REVOKED', required — The certificate lifecycle stage. <br> Active, Expired, and Revoked are all Issued certificates. <br> Active means the validity period includes today. <br> Expired means the validity period was prior to today. <br> Revoked means that the certificate has been revoked. <br> Pending means that the certificate is still going through the issuance process and has not been signed or issued yet. <br> Denied means that the certificate went from pending to denied for any valid denial reason. (Customer canceled request, CAA records exist for the domain, fraud, etc...)
    - `type` 'SINGLE' | 'UCC' | 'WILDCARD', required — The type of certificate in terms of the number of applicable domains.
    - `validEndDate` string, date-time
    - `validStartDate` string, date-time
    - `validationType` 'DV' | 'EV' | 'OV', required — The validation type for the certificate. Standard/Basic Validation (DV). Organizational/Deluxe Vetting (OV). Extended/Premium Validation (EV).
  - `pageSize` integer, required — The page size.
  - `total` integer, required — The total aggregate count.

---

[API](https://skmtc.net/godaddy/apis/untitled-api-2.md) · [All operations](https://skmtc.net/godaddy/apis/untitled-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/godaddy/untitled-api-2/revisions/100b3aa2d7ee/schema)