# Get Subscription Information for SIM Secure for IoT ### `POST /accounts/subscriptions/actions/list` Retrieves the total number of SIM Secure for IoT subscription licenses purchased for your account by license type, and lists the number of licenses assigned and available for each license type. ## Header Parameters The request header must set the content-type to JSON, contain a current ThingSpace authorization token and a current VZ-M2M session token. For more details on how to get these tokens, visit [Getting Started](https://thingspace.verizon.com/documentation/api-documentation.html#/http/session-management/guides/getting-started). | Parameter Name | Data Type | Description | | :------------------------------ | :--------- | :---------------------------------------------------------------- | | **Authorization** *(required)* | string | HTTP Authorization bearer token: `Authorization: Bearer {token}` | | **VZ-M2M-Token** *(required)* | string | A valid session token: `VZ-M2M-Token: {M2Mtoken}` | | **Content-Type** *(required)* | string | Must be application/json `Content-Type: application/json` | ## Uses and Requirements You can retrieve the list of licenses and license types using only your account number, or by using both account number and SKU number. When new licenses are purchased or licenses are removed, the license counts in your account update accordingly. ## HTTP Request [POST https://thingspace.verizon.com/api/m2m/v1/accounts/subscriptions/actions/list](/docs/premium-apis/sim-secure/api-endpoints/account-subscriptions/listaccountsubscriptions) ## Request Parameters | Parameter Name | Data Type | Description | |:----------------|:-----------|:-------------| | accountName *(required)* | string | The name of a billing account, including any leading zeroes. | | skuNumber *(required)* | string (20 characters max string) | The Stock Keeping Unit (SKU). Valid skuNumbers for SIM Secure for IoT are:<br> - `SIMSec-IoT-Lt` (Lifetime) Once a license is assigned to a SIM, the SIM Secure feature is enabled for the life of the SIM.<br> - `TS-BUNDLE-KTO-SIMSEC-MRC` (Bundle) The SIM Secure Flex license can be assigned to or removed from a SIM at any time. This SKU is bundled with other ThingSpace Services.<br> - `SIMSec-IoT` (Flex) The SIM Secure Flex license can be assigned to or removed from a SIM at any time. This SKU is purchased a la carte.<br> - `TSS-IOT-INTLG-TIERED-SIMSEC` (Intelligent Bundle) The SIM Secure flexible license included in the intelligence bundle. | ## Request Body The request body identifies the account name for which you want to show subscription information by licenses and license types. You can also specify the SKU number in the request body to retrieve license information for a specific license type. **Example Request Body, Account Name only:** ```json { "accountName": "0000123456-00001" } ``` **Example Request Body, Account Name and SKU Number:** ```json { "accountName": "0000123456-00001", "skuNumber": "SIMSec-IoT-Lt" } ``` ## Success Responses **Status 200** A successful request returns an array of subscriptionList objects. **Example Success Response for Account Name only:** An example response when the request body included only the accountName. Information for all license types associated with the account is returned. ```json { "accountName": "0000123456-00001", "subscriptionList": [ { "skuNumber": "SIMSec-IoT-Lt", "licenseType": "Lifetime", "licensePurchased": 336000, "licenseAssigned": 507, "licenseAvailable": 335493 }, { "skuNumber": "SIMSec-IoT", "licenseType": "Flexible", "licensePurchased": 100, "licenseAssigned": 5, "licenseAvailable": 95 }, { "skuNumber": "TS-BUNDLE-KTO-SIMSEC-MRC", "licenseType": "Flexible Bundle", "licensePurchased": 200, "licenseAssigned": 7, "licenseAvailable": 193 } ] } ``` **Example Success Response for for Account Name and SKU Number:** An example response when your request body includes both the accountName and the skuNumber. Subscription information only for the specified license type is returned. ```json { "accountName": "0000123456-00001", "subscriptionList": [ { "skuNumber": "SIMSec-IoT-Lt", "licenseType": "Lifetime", "licensePurchased": 336000, "licenseAssigned": 507, "licenseAvailable": 335493 } ] } ``` ## Success Parameters | Parameter Name | Data Type | Description | |:----------------|:-----------|:-------------| | accountName | string | The name of the billing account. | | subscriptionList | array of subscriptionList objects | The list of SKU numbers and counts for each license type specified in the request. | | skuNumber | string | The skuNumber that identifies the license type. <br>`SIMSec-IoT-Lt`. (Lifetime) Once a license is assigned to a SIM, the SIM Secure feature is enabled for the life of the SIM.<br>`TS-BUNDLE-KTO-SIMSEC-MRC`. (Bundle) The SIM Secure Flex license can be assigned to or removed from a SIM at any time. This SKU is bundled with other ThingSpace Services.<br>`SIMSec-IoT`. (Flex) The SIM Secure Flex license can be assigned to or removed from a SIM at any time. This SKU is purchased a la carte. <br>`TSS-IOT-INTLG-TIERED-SIMSEC`. (Intelligent Bundle) The SIM Secure flexible license included in the intelligence bundle. | | licenseType | string | The license type associated with the skuNumber. | | licensePurchased | integer | The total number of licenses purchased for the license type. | | licenseAssigned | integer | The total number of licenses for this license type that are assigned to device SIMs. | | licenseAvailable | integer | The total number of licenses for this license type that are available to assign to device SIMs. | ## Failure Responses Error messages are returned in this format: ```json { "errorCode": "error code string", "errorMessage": "error message string" } ``` ## Error Codes and Messages | Error Code | Error Message | Description | |:-------------------------------------------------|:----------------------------------|:----------------------------------------------| | Carrier.Service.INPUT_INVALID.Action.NotDefined | accountName is a required field. | Your request did not include an accountName. |