Last updated: 5/23/2025 3:33:05 PM
Note
Note
Business role: Distributor (T1), ISP (T1), MSP (T2), and Reseller (T2)
This API is used to create a subscription with specified service plan of product or service.
Each product or service may have one or more service plans. Before creating a subscription, you must confirm the specific service plan that you need. You can access service plan information from the Partners :: Service Plan :: List API.
You can specify the start date of the license for subscription. If you do not provide the start date when creating the subscription, the license will be activated immediately when subscription is created successfully.
Important
Important
When you create a subscription with a Trend Vision One service plan, the assigned customer automatically gains access to Trend Vision One.

Cross Grade

When customer subscribes to a SaaS or Suite service, the subscription might trigger a cross grade process in LMPI.
Cross grade is designed to deal with license conflicts, which occur when you subscribe to a service or suite for your customer, but one or more of the specified services overlap with services the customer already owns. If the specified service or suite is separate from services the customer already owns, the subscription does not cause cross grade.
If a cross grade process is triggered, the existing license is cross-graded into a suite product automatically, if circumstances allow.
Tip
Tip
Be sure to save the subscription ID returned by the API for future use in updating and disabling subscriptions and sending customer notifications.

Request

HTTP Request

[POST] /LMPI/v3/customers/{customer_id}/subscriptions

Parameters

Name
Type
Description
Validation
Required Parameters
customer_id
string
The unique identifier of the customer company that the subscription belongs to.
GUID format

Request Body

{
  "service_plan_id" : "6338528F-E0BE-4A7A-AB6A-C22FDE023AE9",
  "license_start_date" : "2013-01-01T13:01:01Z",
  "units_per_license" : 30
}
Name
Type
Description
Validation
Required Parameters
service_plan_id
string
The unique identifier of the service plan.
GUID format
units_per_license
integer
The total number of licenses under the current created subscription.
For trial service plans, the number of subscribed licenses depends on the backend configuration of the license. You can confirm settings of the available number of trial licenses with your integration contact window.
Positive integer (1-999,999)
Optional Parameters
license_start_date
date
The start date of the license.
If the service plan satisfies one or more of the following conditions, you do not need to provide this parameter.
  • The service plan is a trial.
  • The service plan is configured to activate when customer first signs in to Customer Licensing Portal.
The start date of the license must be the same as or later than the current time.
ISO 8601 standard with format "YYYY-MM-DDThh:mm:ssZ"
data_center
string
The Trend Vision One data center of the downstream partner.
Possible values include:
  • US
  • EU
  • SG
  • JP
  • AU
  • IN
  • MEA
Note
Note
This parameter only applies for Trend Vision One service plans.
Valid partner data center (Default value: The partner’s Remote Manager data center)

Response

Response

If successful, this method returns an HTTP 200 OK status code and a response body with the following structure:
{
  "subscription_id" : "3CB3C2A5-94C5-4D57-9B97-CF4FCC47FF77",
  "product_name" : "Worry Free Business Security Service",
  "licenses" : [{
      "product_id" : "WFBSSVC",
      "version" : "full",
      "ac_code" : "SD-UPTQ-3Z2NK-2T65B-7UC8R-CAVAB-ATMAN",
      "units" : 30,
      "license_start_date" : "2013-01-01T13:01:01Z",
      "license_expiration_date" : "2013-02-01T13:01:01Z",
      "start_charge_date" : "2013-01-01T13:01:01Z"
    }]
}
Name
Type
Description
Length
subscription_id
string
The unique identifier of the subscription.
GUID format
product_name
string
The name of the product or service subscribed to.
1-150 characters
service_url
string
The URL of Customer Licensing Portal, where the customer can sign in for profile management and single sign-on to product websites.
0-300 characters
licenses[].product_id
string
The code representing the specific product or service.
9 characters
licenses[].version
string
The type of license version.
Possible values include:
  • Trial
  • Full
1-10 characters
licenses[].ac_code
string
The license activation code.
Note
Note
For SaaS products and services, the license is activated through specific conditions, not via an activation code.
38 characters
licenses[].units
integer
The number of license units that the current subscription provisions for.
Positive integer (1-999,999)
licenses[].license_start_date
date
The start date and time of license activation.
ISO 8601 standard with format "YYYY-MM-DDThh:mm:ssZ"
licenses[].license_expiration_date
date
The date and time of license expiration.
After the license expiration date, the license grace period begins.
ISO 8601 standard with format "YYYY-MM-DDThh:mm:ssZ"
licenses[].start_charge_date
date
The date and time when the customer company begins to be charged for the license.
ISO 8601 standard with format "YYYY-MM-DDThh:mm:ssZ"