---
title: "Retrieve customer's certificates"
method: GET
path: "/v2/customers/{customerId}/certificates"
tags: ["v2"]
---

# Retrieve customer's certificates

`GET /v2/customers/{customerId}/certificates`

This method can be used to retrieve a list of certificates for a specified customer. <ul><li>**shopperId** is **not the same** as **customerId**.  **shopperId** is a number of max length 10 digits (*ex:* 1234567890) whereas **customerId** is a UUIDv4 (*ex:* 295e3bc3-b3b9-4d95-aae5-ede41a994d13)</li></ul>

## Path parameters

- `customerId` string, required

## Query parameters

- `offset` integer
- `limit` integer

## Response `200`

Customer certificate information retrieved.

- CertificateSummariesV2
  - `certificates` CertificateSummaryV2[], required — List of certificates for a specified customer.
    - `certificateId` string, required — The unique identifier of the certificate request.
    - `commonName` string, domain, required — Common name for the certificate request.
    - `period` integer, required — Validity period of order. Specified in years.
    - `type` 'DV_SSL' | 'DV_WILDCARD_SSL' | 'EV_SSL' | 'OV_CODE_SIGNING' | 'OV_DRIVER_SIGNING' | 'OV_SSL' | 'OV_WILDCARD_SSL' | 'UCC_DV_SSL' | 'UCC_EV_SSL' | 'UCC_OV_SSL', required — Certificate type: * `DV_SSL` - (Domain Validated Secure Sockets Layer) SSL certificate validated using domain name only * `DV_WILDCARD_SSL` - SSL certificate containing subdomains which is validated using domain name only * `EV_SSL` - (Extended Validation) SSL certificate validated using organization information, domain name, business legal status, and other factors * `OV_CODE_SIGNING` - Code signing SSL certificate used by software developers to digitally sign apps. Validated using organization information * `OV_DRIVER_SIGNING` - Driver signing SSL certificate request used by software developers to digitally sign secure code for Windows hardware drivers. Validated using organization information * `OV_SSL` - SSL certificate validated using organization information and domain name * `OV_WILDCARD_SSL` - SSL certificate containing subdomains which is validated using organization information and domain name * `UCC_DV_SSL` - (Unified Communication Certificate) Multi domain SSL certificate validated using domain name only * `UCC_EV_SSL` - Multi domain SSL certificate validated using organization information, domain name, business legal status, and other factors * `UCC_OV_SSL` - Multi domain SSL certificate validated using organization information and domain name
    - `status` 'ISSUED' | 'CANCELED' | 'DENIED' | 'EXPIRED' | 'PENDING_ISSUANCE' | 'PENDING_REKEY' | 'PENDING_REVOCATION' | 'REVOKED' | 'UNUSED', required — Certificate status (if issued or revoked): * `CANCELED` - Certificate request was canceled by customer * `DENIED` - Certificate request was denied by customer * `EXPIRED` - Issued certificate has exceeded the valid end date * `ISSUED` - Certificate has been issued and is within validity period * `PENDING_ISSUANCE` - Certificate request has completed domain verification and is in the process of being issued * `PENDING_REKEY` - Previously issued certificate was rekeyed by customer and is in the process of being reissued * `PENDING_REVOCATION` - Previously issued certificate is in the process of being revoked * `REVOKED` - Issued certificate has been revoked * `UNUSED` - Certificate in an error state
    - `createdAt` string, iso-datetime, required — Date that the certificate request was received.
    - `completedAt` string, iso-datetime — The date the certificate request completed processing (if issued or revoked).
    - `validEndAt` string, iso-datetime — The end date of the certificate's validity (if issued or revoked).
    - `validStartAt` string, iso-datetime — The start date of the certificate's validity (if issued or revoked).
    - `revokedAt` string, iso-datetime — The revocation date of certificate (if revoked).
    - `renewalAvailable` boolean — Only returned when a renewal is available.
    - `serialNumber` string — Serial number of certificate (if issued or revoked).
    - `slotSize` 'FIVE' | 'TEN' | 'FIFTEEN' | 'TWENTY' | 'THIRTY' | 'FOURTY' | 'FIFTY' | 'ONE_HUNDRED' — Number of subject alternative names (SAN) to be included in certificate (if UCC): * `FIVE` - Five slot UCC request * `TEN` - Ten slot UCC request * `FIFTEEN` - Fifteen slot UCC request * `TWENTY` - Twenty slot UCC request * `THIRTY` - Thirty slot UCC request * `FOURTY` - Fourty slot UCC request * `FIFTY` - Fifty slot UCC request * `ONE_HUNDRED` - One hundred slot UCC request
    - `subjectAlternativeNames` string[] — Subject Alternative names (if UCC). Collection of subjectAlternativeNames to be included in certificate.
  - `pagination` Pagination, required
    - `first` string — URI to access the first page
    - `previous` string — URI to access the previous page
    - `next` string — URI to access the next page
    - `last` string — URI to access the last page
    - `total` integer — Number of records available

## Other responses

- `401` — Authentication info not sent or is invalid
- `403` — Authenticated user is not allowed access
- `422` — Application-specific request error
- `429` — Too many requests received within interval
- `500` — Internal server error

---

[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)