# Get FOTA Subscription ### `GET /subscriptions/{accountName}` Retrieves the number of FOTA subscriptions for HTTP devices by account. ## Uses and Requirements This API returns information for licenses applied to HTTP devices. ## HTTP Request GET [https://thingspace.verizon.com/api/fota/v2/subscriptions/{accountName}](/docs/premium-apis/software-management/software-management-v1/api-endpoints/software-management-subscriptions-v1/getaccountsubscriptionstatus) ## Resource Path and Query Parameters You must include the account name in the path. | Parameter Name | Data Type | Description | |:-----------------------|:-----------|:-----------------------------------------------------| | **accountName** <br> _required_ | string | Account identifier. | ## Header Parameters The request header must 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** <br> _required_ | string | HTTP Authorization bearer token: <br> `Authorization: Bearer {token}` | | **VZ-M2M-Token** <br> _required_ | string | A valid session token: <br> `VZ-M2M-Token: {M2Mtoken}` | ## Request Body None ## Example Request: Retrieve the number of licenses assigned to HTTP devices for the account. ``` json curl https://thingspace.verizon.com/api/fota/v2/subscriptions/0402196254-00001 \ -H 'Authorization: Bearer $AUTH_TOKEN' \ -H 'VZ-M2M-Token: $M2M_TOKEN' ``` ## Success Response **Status 200** | Parameter | Data Type | Description | |:----------------------|:----------|:-----------------------------------------------------------------------------| | **accountName** | string | The name (number) of the billing account. | | **purchaseType** | string | Comma-separated list of subscription models used by the account: <ul><li> `TS-HFOTA-MRC` - a monthly recurring contract for a fixed number of licenses.</li> <li> `TS-HFOTA-EVNT` - a post-pay plan in which the account is billed for the number of licenses used in each month (the number of events)</li> <li>both of the above</li></ul> | | **licenseCount** | string | The Number of monthly licenses in an MRC subscription. This is zero for accounts that have only Event subscriptions. | | **licenseUsedCount** | string | Number of licenses currently assigned to devices. | | **updateTime** | string | The date and time when the subscription was last updated. | ## Example Success Response ``` json { "accountName": "00000000000-123345", "purchaseType": "TS-HFOTA-EVNT,TS-HFOTA-MRC", "licenseCount": 500, "licenseUsedCount": 400, "updateTime": "2020-09-17T21:11:32.170Z" } ``` ## Failure Response **Status 400** All error messages are returned in this format: ``` json { "errorCode": "error code string", "errorMessage": "error message string" } ``` Error codes and messages are listed on the Error Messages page, along with explanations and suggestions for corrective actions.