Guides
Guides

get_products

Request parameters for get_products

Standard parameters

  • action = get_products
  • object = trust_service

Attributes

Parameters within the attributes associative array are described below.

Parameter nameObligationDefinition/Value
max_expiry_dateRequired

Used in conjunction with min_expiry_date attribute
The latest expiry date to use to generate a list of Trust Service products.

Date must be in the format YYYY-MM-DD.

min_expiry_dateRequired

Used in conjunction with max_expiry_date attribute. The earliest expiry date to use to generate a list of Trust Service products.

Date must be in the format YYYY-MM-DD.

stateOptionalThe state of the Trust Service products that you want returned. Allowed values are:
  • activated
  • active
  • expired
  • renewed
  • revoked
  • upgraded

Response parameters for get_products

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

Parameters within the attributes associative array are described below.

Parameter nameObligationDefinition/Value
product_listReturned if is_success =
true

An array that lists the products whose expiry dates are within a specific date range.

For more information, see the product_list table below.

product_list

Parameters within the product_list associative array are described below.

Parameter nameObligationDefinition/Value
contact_emailReturned if is_success = trueThe email contact from the order.
domainReturned if is_success = trueThe domain or hostname to which the Trust Service applies.
expiry_dateReturned if is_success = trueThe date that the Trust Service product expires.
is_renewableReturned if is_success = true

Indicates whether the product is can be renewed at this time. Trust Service products can be renewed between 60 days before the expiry date and 15 days after expiry date.

Allowed values are:

  • 0—Product cannot be renewed at this
    time.

  • 1—Product can be renewed.

issue_dateReturned if is_success = trueThe date that the Trust Service product was
issued.
product_idReturned if is_success =
true		The ID number of the Trust Service product
product_typeReturned if is_success =
true

The 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

  • malwarescan

  • quickssl

  • quickssl_premium

  • securesite

  • securesite_ev

  • securesite_pro

  • securesite_pro_ev

  • sgcsuper_certs

  • sitelock_basic

  • sitelock_premium

  • sitelock_enterprise

  • sitelock_find

  • sitelock_fix

  • sitelock_prevent

  • sitelock_911

  • ssl123

  • sslwebserver

  • sslwebserver_ev

  • sslwebserver_wildcard

  • symantec_ssl_lite

  • symantec_ssl_lite_wildcard

  • truebizid

  • truebizid_ev

  • truebizid_wildcard

  • truste_hpp (Hosted Privacy Policy)

  • truste_tps (TRUSTE Privacy Policy with
    seal)

  • trustwave_dv

  • trustwave_ev

  • trustwave_premiumssl

  • trustwave_premiumssl_wildcard

start_dateReturned if is_success =
true		The effective date for the Trust Service.
stateReturned if is_success =
true

The state of the Trust Service product.

Allowed values are:

  • approver-confirmed—Owner has confirmed the domain vetted certificate.

  • awaiting-approval—Order processed successfully; waiting for supplier
    approval.

  • cancelled —Pending order was
    cancelled.

  • completed—Order is complete.

  • declined—Order cancelled after it was
    processed or declined by the supplier.

  • in-progress—Order is in progress.

  • pending—Order saved as pending.

Examples for get_products

Request

<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<OPS_envelope>
    <header>
        <version>0.9</version>
    </header>
    <body>
        <data_block>
            <dt_assoc>
                <item key="protocol">XCP</item>
                <item key="action">get_products</item>
                <item key="object">trust_service</item>
                <item key="attributes">
                    <dt_assoc>
                        <item key="min_expiry_date">2012-04-23</item>
                        <item key="state">expired</item>
                        <item key="max_expiry_date">2012-09-22</item>
                    </dt_assoc>
                </item>
            </dt_assoc>
        </data_block>
    </body>
</OPS_envelope>

Response

<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<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="response_code">200</item>
                <item key="attributes">
                    <dt_assoc>
                        <item key="product_list">
                            <dt_array>
                                <item key="0">
                                    <dt_assoc>
                                        <item key="expiry_date">2012-04-23T10:41:04.000-
                                            04:00</item>
                                        <item key="state">expired</item>
                                        <item key="product_type">quickssl</item>
                                        <item key="issue_date">2012-04-16T09:17:46.000-
                                            04:00</item>
                                        <item key="domain">example.org</item>
                                        <item key="product_id">2094</item>
                                        <item key="contact_email">[email protected]</item>
                                        <item key="is_renewable">0</item>
                                        <item key="start_date">2012-04-14T20:14:48.000-
                                            04:00</item>
                                    </dt_assoc>
                                </item>
                                <item key="1">
                                    <dt_assoc>
                                        <item key="expiry_date">2012-05-08T07:34:49.000-
                                            04:00</item>
                                        <item key="state">expired</item>
                                        <item key="product_type">securesite_pro</item>
                                        <item key="issue_date">2012-04-30T11:27:59.000-
                                            04:00</item>
                                        <item key="domain">example.net</item>
                                        <item key="product_id">2096</item>
                                        <item key="contact_email">[email protected]</item>
                                        <item key="is_renewable">0</item>
                                        <item key="start_date">2012-04-28T19:42:30.000-
                                            04:00</item>
                                    </dt_assoc>
                                </item>
                            </dt_array>
                        </item>
                    </dt_assoc>
                </item>
                <item key="is_success">1</item>
            </dt_assoc>
        </data_block>
    </body>
</OPS_envelope>