GET/partners/customers/{domainId}/subscriptions

Gets a list of active subscriptions.

Authorization

oauth2

OAuth 2.0 authentication. For more information, see Authentication and Authorization.

Scope

partner
partner.read

HTTP Request

GEThttps://www.worksapis.com/v1.0/partners/customers/{domainId}/subscriptions

Path Parameters

ParameterTypeDescription
domainId integer 

Domain ID


required
example : 10000001 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 

Response

HTTP 200

OK

PropertyTypeDescription
subscriptions array (Subscriptions) 

This model specifies the subscription in use, paid contract type, and Trial status. It is used to set a subscription. It contains the subscription renewal information as well as the current subscription information.

  • It contains the subscription renewal information only for paid plans.
 

Subscriptions

PropertyTypeDescription
domainId integer 

Domain ID


required
readOnly : true 
subscriptionId integer 

Subscription ID


required 
productId string 
  • LINE WORKS Service
    • STD_T: Standard Trial plan
    • ADV_T: Advanced Trial plan
    • STD: Standard plan
    • ADV: Advanced plan

required
Allowed values : STD_T, ADV_T, STD, ADV 
plan string 

Contract type

  • TRIAL: Trial
  • MONTHLY: Monthly contract postpay
  • ANNUAL_LICENSE: Annual contract monthly license
  • ANNUAL_PREPAY_LICENSE: Annual contract lump sum license

Applicable contract types by plan group

  • LINE WORKS Service
    • TRIAL: Trial
    • MONTHLY: Monthly contract postpay
    • ANNUAL_LICENSE: Annual contract monthly license
    • ANNUAL_PREPAY_LICENSE: Annual contract lump sum license

required
Allowed values : TRIAL, MONTHLY, ANNUAL_LICENSE, ANNUAL_PREPAY_LICENSE 
planStartDate string 

Start date


required
format : date
readOnly : true 
planEndDate string 

End date

  • For a paid plan, it is the plan end date.

format : date
readOnly : true
nullable : true 
licenseAssignType string 

License assignment type

  • NONE: None
 
licenseCount integer 

Number of licenses


nullable : true 
status string 

Subscription status

  • ACTIVE: Active
  • SUSPENDED_TRIALEND: Suspended (Trial ended)

required
Allowed values : ACTIVE, SUSPENDED_TRIALEND 
renewal object (renewal) 

This model specifies renewal of a paid subscription. Use the type property to choose whether to renew the subscription with the current conditions or to change them. It is also possible to reduce the number of licenses upon renewal.

 

renewal

PropertyTypeDescription
subscriptionId integer 

Subscription ID


required 
type string 

Subscription renewal type

  • STAY: Renew the subscription under the same conditions.
  • CHANGE: Renew the subscription with changes (which are specified as parameters)
  • CANCEL: No renewal (cancellation)

required
Allowed values : STAY, CHANGE, CANCEL 
productId string 

Paid plan ID

  • LINE WORKS Service
    • STD: Standard plan
    • ADV: Advanced plan

Allowed values : STD, ADV 
plan string 

Paid contract type

  • MONTHLY: Monthly contract postpay
  • ANNUAL_LICENSE: Annual contract monthly license
  • ANNUAL_PREPAY_LICENSE: Annual contract lump sum license

Applicable contract types by plan group

  • LINE WORKS Service
    • MONTHLY: Monthly contract postpay
    • ANNUAL_LICENSE: Annual contract monthly license
    • ANNUAL_PREPAY_LICENSE: Annual contract lump sum license

Allowed values : MONTHLY, ANNUAL_LICENSE, ANNUAL_PREPAY_LICENSE 
licenseCount integer 

Number of licenses to apply at the time of renewal


maximum : 1000000 

Response Example

Example 1

1{2  "subscriptions": [3    {4      "domainId": 0,5      "subscriptionId": 0,6      "productId": "STD_T",7      "plan": "TRIAL",8      "planStartDate": "2019-08-24",9      "planEndDate": "2019-08-24",10      "licenseCount": 0,11      "status": "ACTIVE",12      "renewal": {13        "subscriptionId": 0,14        "type": "STAY",15        "productId": "STD",16        "plan": "MONTHLY",17        "licenseCount": 100000018      }19    }20  ]21}