---
title: "Get a page of subscriptions by domain"
method: GET
path: "/v2/certificates/subscriptions/search"
tags: ["v2"]
---

# Get a page of subscriptions by domain

`GET /v2/certificates/subscriptions/search`

The pagination starts at page 1. Each page contains a page of *subscriptions*, not certificates. This endpoint is meant for paging the subscriptions under the authorized user's account. Each subscription contains a snapshot of certificates contained within the subscription. To fetch further certificates under a subscription, use the /v2/certificates/subscription/{guid} endpoint with the subscription GUID obtained from this call. If any filtering is applied, subscriptions without any certificates will be omitted.

## 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

- CertificatesByDomainPage
  - `currentPage` integer, required — The page number.
  - `data` CertificatesByDomainPaged[], required
    - `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.
  - `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)