--- title: "Retrieve individual certificate details" method: GET path: "/v2/customers/{customerId}/certificates/{certificateId}" tags: ["v2"] --- # Retrieve individual certificate details `GET /v2/customers/{customerId}/certificates/{certificateId}` Once the certificate order has been created, this method can be used to check the status of the certificate. This method can also be used to retrieve details of the certificate. ## Path parameters - `customerId` string, required - `certificateId` string, required ## Response `200` Certificate details retrieved - CertificateDetailV2 - `certificateId` string, required — The unique identifier of the certificate request. Only present if no errors returned - `commonName` string, domain, required — Common name of certificate - `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` 'PENDING_ISSUANCE' | 'ISSUED' | 'REVOKED' | 'CANCELED' | 'DENIED' | 'PENDING_REVOCATION' | 'PENDING_REKEY' | 'UNUSED' | 'EXPIRED', required — Certificate status (if issued or revoked): * `CANCELED` - Certificate request was canceled by customer * `DENIED` - Certificate request was denied by customer\n * `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\n * `UNUSED` - Certificate in an error state - `createdAt` string, iso-datetime, required — The date the certificate was ordered. - `completedAt` string, iso-datetime — The date the certificate request completed processing. - `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) - `serialNumberHex` string — Hexadecmial format for 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. Collection of subjectAlternativeNames to be included in certificate. - `contact` CertificateContact, required - `email` string, required — Email address of requestor contact - `jobTitle` string — Only used for EVSSL. Job title of requestor contact - `nameFirst` string, required — First name of requestor contact - `nameLast` string, required — Last name of requestor contact - `nameMiddle` string — Middle initial of requestor contact - `phone` string, required — Phone number for requestor contact - `suffix` string — Suffix of requestor contact - `organization` CertificateOrganization - `address` CertificateAddress, required - `address1` string, required — Address line 1 of organization address - `address2` string — Address line 2 of organization address - `city` string — City/Locality of organization address - `country` 'AC' | 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AN' | 'AO' | 'AQ' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BM' | 'BN' | 'BO' | 'BR' | 'BS' | 'BT' | 'BV' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CV' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MG' | 'MH' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'ST' | 'SV' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TP' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'YE' | 'YT' | 'YU' | 'ZA' | 'ZM' | 'ZW', iso-country-code, required — Two character country code of organization - `postalCode` string — Postal code of organization address - `state` string — Full name of State/Province/Territory of organization address - `assumedName` string — Only for EVSSL. The DBA(does business as) name for the organization. - `jurisdictionOfIncorporation` JurisdictionOfIncorporation - `city` string - `country` string, iso-country-code, required - `county` string - `state` string - `name` string, required — Name of organization that owns common name - `phone` string, required — Phone number for organization - `registrationAgent` string — Only for EVSSL. - `registrationNumber` string — Only for EVSSL. - `csr` string — Certificate signing request (if present) in PEM format - `rootType` 'GODADDY_SHA_1' | 'GODADDY_SHA_2' | 'STARFIELD_SHA_1' | 'STARFIELD_SHA_2' — Root type: * `GODADDY_SHA_1` - GoDaddy (Secure Hash Algorithm 1) SHA-1 root type * `GODADDY_SHA_2` - GoDaddy (Secure Hash Algorithm 2) SHA-2 root type * `STARFIELD_SHA_1` - Starfield SHA-1 root type * `STARFIELD_SHA_2` - Starfield SHA-2 root type - `deniedReason` string — Only present if certificate order has been denied - `progress` integer — Percentage of completion for certificate vetting ## Other responses - `401` — Authentication info not sent or is invalid - `403` — Authenticated user is not allowed access - `404` — Resource not found - `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)