query_approver_list

Queries the list of approvers for the SSL service that is associated with a specified domain.

📘

Note:

This command is currently not supported for Trustwave certificates.

Request parameters for query_approver_list

Standard parameters

  • action = query_approver_list
  • object = trust_service attributes

Attributes

Parameters within the attributes associative array are described below.

Parameter nameObligationDefinition/Value
domainRequiredThe domain to which the SSL Service approver list belongs.
product_typeRequiredThe product type from the SSL Certificate inventory.
Allowed values are:

comodo_ev

comodo_instantssl

comodo_premiumssl

comodo_premiumssl_wildcard

comodo_ssl

comodo_wildcard

essentialssl

essentialssl_wildcard

positivessl

quickssl

quickssl_premium

securesite

securesite_pro

securesite_ev

securesite_pro_ev

sgcsuper_certs

ssl123

sslwebserver

sslwebserver_wildcard

sslwebserver_ev

symantec_ssl_lite

symantec_ssl_lite_wildcard

truebizid

truebizid_wildcard

truebizid_ev

**As of September 30th 2020, The following products will no longer be available:

quickssl (translate to quickssl_premium)
thawte_csc (Thawte Code Signing)
securesite_ft
securesite_pro_ft
securesite_ev_ft
securesite_pro_ev_ft
truebizid_ev_ft

Response parameters for query_approver_list

Standard parameters

  • action = reply
  • object = trust_service
  • is_success = a Boolean is returned, indicating success or failure of the
    request
  • response_code = response code indicating outcome of the request
  • response_text = message describing the outcome of the request

Attributes

If the request is successful, the attributes associative array may include the following:

Parameter nameObligationDefinition/Value
approver_listReturned if is_success = trueThe list of approvers and their properties. For more information, see the approver_list table.

Approver_list

Parameters within the approver_list associative array are described below.

Parameter nameObligationDefinition/Value
domainAlways returnedThe domain to which the SSL Service applies.
emailAlways returnedSSL Service approver email address.
typeAlways returnedSSL Service approver type. Allowed values are:

generic—Generated by pre-pending predefined list of prefixes to the domain name. Prefixes include admin, administrator, hostmaster, root, webmaster, postmaster, and support.

manual—A list of support addresses taken from WHOIS.

Examples for query_approver_list

Request

<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
    <header>
        <version>0.9</version>
    </header>
    <body>
        <data_block>
            <dt_assoc>
                <item key="protocol">XCP</item>
                <item key="action">query_approver_list</item>
                <item key="object">trust_service</item>
                <item key="attributes">
                    <dt_assoc>
                        <item key="domain">example.com</item>
                        <item key="product_type">quickssl</item>
                    </dt_assoc>
                </item>
            </dt_assoc>
        </data_block>
    </body>
</OPS_envelope>

Response

<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
    <header>
        <version>0.9</version>
    </header>
    <body>
        <data_block>
            <dt_assoc>
                <item key="protocol">XCP</item>
                <item key="action">REPLY</item>
                <item key="object">TRUST_SERVICE</item>
                <item key="response_text">Command completed successfully.</item>
                <item key="is_success">1</item>
                <item key="response_code">200</item>
                <item key="attributes">
                    <dt_assoc>
                        <item key="approver_list">
                            <dt_array>
                                <item key="0">
                                    <dt_assoc>
                                        <item key="email">[email protected]</item>
                                        <item key="domain">example.com</item>
                                        <item key="type">MANUAL</item>
                                    </dt_assoc>
                                </item>
                                <item key="1">
                                    <dt_assoc>
                                        <item key="email">[email protected]</item>
                                        <item key="domain">example.com</item>
                                        <item key="type">MANUAL</item>
                                    </dt_assoc>
                                </item>
                                <item key="2">
                                    <dt_assoc>
                                        <item key="email">[email protected]</item>
                                        <item key="domain">example.com</item>
                                        <item key="type">GENERIC</item>
                                    </dt_assoc>
                                </item>
                                <item key="3">
                                    <dt_assoc>
                                        <item key="email">[email protected]</item>
                                        <item key="domain">example.com</item>
                                        <item key="type">GENERIC</item>
                                    </dt_assoc>
                                </item>
                                <item key="4">
                                    <dt_assoc>
                                        <item key="email">[email protected]</item>
                                        <item key="domain">example.com</item>
                                        <item key="type">GENERIC</item>
                                    </dt_assoc>
                                </item>
                                <item key="5">
                                    <dt_assoc>
                                        <item key="email">[email protected]</item>
                                        <item key="domain">example.com</item>
                                        <item key="type">GENERIC</item>
                                    </dt_assoc>
                                </item>
                                <item key="6">
                                    <dt_assoc>
                                        <item key="email">[email protected]</item>
                                        <item key="domain">example.com</item>
                                        <item key="type">GENERIC</item>
                                    </dt_assoc>
                                </item>
                                <item key="7">
                                    <dt_assoc>
                                        <item key="email">[email protected]</item>
                                        <item key="domain">example.com</item>
                                        <item key="type">GENERIC</item>
                                    </dt_assoc>
                                </item>
                                <item key="8">
                                    <dt_assoc>
                                        <item key="email">[email protected]</item>
                                        <item key="domain">example.com</item>
                                        <item key="type">MANUAL</item>
                                    </dt_assoc>
                                </item>
                            </dt_array>
                        </item>
                    </dt_assoc>
                </item>
            </dt_assoc>
        </data_block>
    </body>
</OPS_envelope>