--- title: "Get alias certificate issuing details" method: GET path: "/cdn/aliases/{alias_id}/status" tags: ["Aliases"] --- # Get alias certificate issuing details `GET /cdn/aliases/{alias_id}/status` ## Request - Base URL: `https://api.gcore.com` - URL: `https://api.gcore.com/cdn/aliases/{alias_id}/status` - Auth: HTTP apikey Get details about the latest Let's Encrypt certificate issuance attempt for an alias, including the CNAME records to create for domain validation and the state of each domain validation challenge. Returns attempts in all statuses. While the alias is switching to a Let's Encrypt certificate, the attempt for the new certificate is returned. ## Path parameters - `alias_id` integer, required ## Response `200` Successful. - AliasCertificateStatus - `id` integer: ID of the attempt to issue a Let's Encrypt certificate. - `statuses` LERequestAttemptStatus[]: Detailed information about attempts to issue a Let's Encrypt certificate. - `id` integer: ID of the attempt to issue the Let's Encrypt certificate. - `status` string: Status of the attempt to issue the Let's Encrypt certificate. Possible values: - `DONE` – Attempt is successful. Let's Encrypt certificate was issued. - `FAILED` – Attempt failed. Let's Encrypt certificate was not issued. - `CANCELLED` – Attempt is cancelled. Let's Encrypt certificate was not issued. - `FORBIDDEN` – Issuing of Let's Encrypt certificates is disabled for your account. Let's Encrypt certificate was not issued. - `error` string: Brief description of the error that occurred when trying to issue a Let's Encrypt certificate. - `details` string: Detailed description of the error that occurred when trying to issue a Let's Encrypt certificate. - `created` string: Date and time when the issuing attempt status was created (ISO 8601/RFC 3339 format, UTC). - `retry_after` string: Date indicating when the certificate issuance limit will be lifted (ISO 8601/RFC 3339 format, UTC). It is filled in only if error = RateLimited. - `latest_status` LERequestAttemptStatus - `id` integer: ID of the attempt to issue the Let's Encrypt certificate. - `status` string: Status of the attempt to issue the Let's Encrypt certificate. Possible values: - `DONE` – Attempt is successful. Let's Encrypt certificate was issued. - `FAILED` – Attempt failed. Let's Encrypt certificate was not issued. - `CANCELLED` – Attempt is cancelled. Let's Encrypt certificate was not issued. - `FORBIDDEN` – Issuing of Let's Encrypt certificates is disabled for your account. Let's Encrypt certificate was not issued. - `error` string: Brief description of the error that occurred when trying to issue a Let's Encrypt certificate. - `details` string: Detailed description of the error that occurred when trying to issue a Let's Encrypt certificate. - `created` string: Date and time when the issuing attempt status was created (ISO 8601/RFC 3339 format, UTC). - `retry_after` string: Date indicating when the certificate issuance limit will be lifted (ISO 8601/RFC 3339 format, UTC). It is filled in only if error = RateLimited. - `started` string: Date when the process of issuing a Let's Encrypt certificate was started (ISO 8601/RFC 3339 format, UTC). - `finished` string, nullable: Date when the process of issuing a Let's Encrypt certificate was finished (ISO 8601/RFC 3339 format, UTC). The field is `null` if the issuing process is not finished. - `active` boolean: Defines whether the Let's Encrypt certificate issuing process is active. Possible values: - `true` – Issuing process is active. - `false` – Issuing process is completed. - `attempts_count` integer: Number of attempts to issue the Let's Encrypt certificate. - `next_attempt_time` string, nullable: Time of the next scheduled attempt to issue the Let's Encrypt certificate (ISO 8601/RFC 3339 format, UTC). - `reason` string, nullable: Why this attempt was opened. Possible values: - `initial` – First attempt to issue a certificate. - `renewal` – A scheduled renewal of an existing certificate. - `manual` – Manually triggered, for example via a retry. - `switch` – Switching from your own certificate to a Let's Encrypt certificate. - `extend` – Extending the set of domains covered by the certificate. - `challenge_type` string, nullable: The domain validation method this attempt uses. Possible values: - `dns_01` – Validation via a DNS record. - `http_01` – Validation via an HTTP request. - `requested_domains` string[], nullable: Domains this attempt requested a certificate for. - `challenges` LEChallengeStatus[]: Domain validation challenges of the latest order placed with Let's Encrypt, one per domain. - `domain` string: Domain the challenge validates. - `challenge_type` string: Domain validation method of the challenge. Possible values: - `dns_01` – Validation via a DNS record. - `http_01` – Validation via an HTTP request. - `state` string: State of the challenge. Possible values: - `pending` – The challenge has not been checked yet. - `processing` – Let's Encrypt is validating the challenge. - `valid` – The challenge passed. - `invalid` – The challenge failed; see `error`. - `error` string: Why the challenge failed. Empty unless `state` is `invalid`. - `validation_state` string: State of the domain validation for this attempt. Possible values: - `PENDING` – Validation has not started yet. - `AWAITING_CNAME` – Waiting for the CNAME records below to be created. - `VALIDATING` – Validation is in progress. - `COMPLETED` – Validation succeeded. - `FAILED` – Validation did not succeed. - `resource` integer, nullable: Always `null` for an alias. - `cname_records` AliasCnameRecord[]: CNAME records to create so Let's Encrypt domain validation can complete for the alias hostname. Empty when the attempt uses `http_01`. - `cname_name` string: Hostname to create the CNAME record for. - `cname_target` string: Value the CNAME record must point to. ## Other responses - `400`: The alias serves a certificate you added yourself, or issuance has not started for it yet. - `403`: Aliases are not enabled for your account. - `404`: The alias does not exist. ## Changes - **2026-10-21** `d034c0d6d6ff`: 4 info - added `#/components/schemas/LERequestStatusBase` to the response body `allOf` list for the response status `200` - removed `#/components/schemas/LERequestStatusV2` from the response body `allOf` list for the response status `200` - added the optional property `allOf[#/components/schemas/StandaloneLERequestEvidence]/challenges` to the response with the `200` status - added the optional property `allOf[subschema #3]/resource` to the response with the `200` status - **2026-09-28** `9b685d687b49`: 1 info - endpoint added [Operation history](https://skmtc.dev/g-core/apis/gcore-openapi/changes/cdn/aliases/:alias_id/status/get.md) --- [API](https://skmtc.dev/g-core/apis/gcore-openapi.md) - [All operations](https://skmtc.dev/g-core/apis/gcore-openapi/llms.txt) - [OpenAPI document](https://skmtc.dev/g-core/apis/gcore-openapi/revisions/a2b772345f3a?raw)