---
title: "Return SSL certificate's info for dedicated IP"
method: GET
path: "/SSL/installed_host"
tags: ["SSL", "cPanel Account SSL Management"]
---

# Return SSL certificate's info for dedicated IP

`GET /SSL/installed_host`

This function retrieves information about a certificate that is installed on a domain's dedicated IP address.

**Important:**

  * If you do **not** possess a dedicated IP address, this function will **fail**. For non-dedicated IP addresses, use the `SSL::installed_hosts` function.
  * When you disable the _Calendars and Contacts_, _Receive Mail_, _Web Disk_ , _Webmail_ , **and**  _Web Server_ [roles](https://go.cpanel.net/howtouseserverprofiles#roles), the system **disables** this function.

## Query parameters

- `domain` string, domain
- `verify_certificate` 0 | 1

## Response `200`

HTTP Request was successful.

- object
  - `apiversion` integer — The version of the API.
  - `func` string — The name of the method called.
  - `module` string — The name of the module called.
  - `result` object
    - `data` object
      - `certificate` object — An object containing the certificate information.
        - `domains` string[] — The domains that the certificate covers.
        - `ecdsa_curve_name` 'prime256v1' | 'secp384r1', nullable — The ECDSA curve that the certificate's key uses. * `prime256v1` * `secp384r1` * `null` — The certificate's key is **not** an ECDSA key.
        - `ecdsa_public` string, nullable — The certificate's key's ECDSA compressed public point, in hexadecimal format. * `null` — The certificate's key is **not** an ECDSA key.
        - `id` string — The certificate's ID.
        - `is_self_signed` 0 | 1 — Whether the certificate is self-signed. * `1` — Self-signed. * `0` — Not self-signed.
        - `issuer.commonName` string — The issuer's Common Name, typically a domain name.
        - `issuer.organizationName` string — The certificate's organization.
        - `issuer_text` string — The X.509 information about the issuer that contains CSR information.
        - `key_algorithm` 'rsaEncryption' | 'id-ecPublicKey' — The certificate's key's algorithm. * `rsaEncryption` — RSA. * `id-ecPublicKey` — ECDSA.
        - `modulus` string, nullable — The certificate's key's modulus, in hexadecimal format. * `null` — The certificate's key is **not** an RSA key.
        - `modulus_length` integer, nullable — The length, in bits, of the certificate's key's modulus. * `null` — The certificate's key is **not** an RSA key.
        - `not_after` integer — The certificate's expiration time.
        - `not_before` integer — The certificate's start time.
        - `signature_algorithm` string — The signature algorithm of the certificate.
        - `subject.commonName` string — The certificate's Common Name.
        - `subject_text` string — The X.509 information about the certificate's subject that contains CSR information.
        - `validation_type` 'ev' | 'ov' | 'dv', nullable — The certificate's validation type. * `ev` — Extended Validation. * `ov` — Organization Validation. * `dv` — Domain Validation. * `null` — The system could not parse and determine the certificate's validation type.
        - `verify_error` string — Any errors that exist during the certificate verification process. If there are no errors, this will return an empty string. **Note:** You **must** set the `verify_certificate` parameter to `1` for this return to appear.
      - `host` string, domain — The issuer's hostname.
    - `errors` string[], nullable — List of errors if the API failed.
    - `messages` string[], nullable — List of messages generated by the API.
    - `metadata` object
    - `status` 0 | 1 — * `1` — Success. * `0` — Failed. Check the `errors` field for more details.
    - `warnings` string[], nullable — List of warnings generated by the API. Warnings describe non-critical failures or other problematic conditions noted while running a API.

---

[API](https://skmtc.net/cpanel/apis/cpanel-uapi.md) · [All operations](https://skmtc.net/cpanel/apis/cpanel-uapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cpanel/cpanel-uapi/versions/632e2f8e6d04/schema)