---
title: "Retrieve certificate details"
method: GET
path: "/v1/certificates/{certificateId}"
tags: ["v1"]
---

# Retrieve certificate details

`GET /v1/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

- `certificateId` string, required

## Response `200`

Certificate details retrieved

- Certificate
  - `certificateId` string, required — The unique identifier of the certificate request. Only present if no errors returned
  - `commonName` string — Common name of 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
  - `createdAt` string, iso-datetime, required — The date the certificate was ordered.
  - `deniedReason` string — Only present if certificate order has been denied
  - `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.
  - `period` integer, required — Validity period of order. Specified in years
  - `productType` 'DV_SSL' | 'DV_WILDCARD_SSL' | 'EV_SSL' | 'OV_CS' | 'OV_DS' | 'OV_SSL' | 'OV_WILDCARD_SSL' | 'UCC_DV_SSL' | 'UCC_EV_SSL' | 'UCC_OV_SSL', required — Certificate product type
  - `progress` integer — Percentage of completion for certificate vetting
  - `revokedAt` string, iso-datetime — The revocation date of certificate (if revoked).
  - `rootType` 'GODADDY_SHA_1' | 'GODADDY_SHA_2' | 'STARFIELD_SHA_1' | 'STARFIELD_SHA_2' — Root Type
  - `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
  - `status` 'PENDING_ISSUANCE' | 'ISSUED' | 'REVOKED' | 'CANCELED' | 'DENIED' | 'PENDING_REVOCATION' | 'PENDING_REKEY' | 'UNUSED' | 'EXPIRED', required — Status of certificate
  - `subjectAlternativeNames` SubjectAlternativeNameDetails[] — Contains subject alternative names set
    - `status` 'PENDING' | 'INVALID' | 'COMPLETED' | 'FRAUD', required — Total number of page results
    - `subjectAlternativeName` string, required — Subject alternative name to be included in certificate
  - `validEnd` string, iso-datetime — The end date of the certificate's validity (if issued or revoked).
  - `validStart` string, iso-datetime — The start date of the certificate's validity (if issued or revoked).

## Other responses

- `400` — Request was malformed
- `401` — Authentication info not sent or invalid
- `403` — Authenticated user is not allowed access
- `404` — Certificate id not found
- `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/versions/100b3aa2d7ee/schema)
