Smarthands Support Plans (2.0-beta)
Download OpenAPI specification:Download
The Smart Hands Support plan API allows users to retrieve information of their purchased plan. Information includes but is not limited to plan name, plan type, purchased minutes, consumed minutes, and remaining minutes for Smart Hands. The authorization token and content-type are the only headers that are passed to this API and a response is received based on the values passed.
Retrieve Smart Hands support plans
This method retrieves all the available Smart Hands support plans and its remaining minutes to consume for a user with Smart Hands support plans viewing permission.
Authorizations:
query Parameters
accountNumbers | Array of strings List of accounts to be filtered |
ibxs | Array of strings List of IBXs to be filtered |
offset | integer >= 0 Default: 0 Use |
limit | integer [ 1 .. 200 ] Default: 10 Use |
sorts | Array of strings Items Enum: "START_DATE" "-START_DATE" "END_DATE" "-END_DATE" "ACCOUNT_NUMBER" "-ACCOUNT_NUMBER" "ID" "-ID" "PLAN_NAME" "-PLAN_NAME" Sort the users in the response in a particular order. For descending order, prefix the field name with '-'. |
planIds | Array of strings [ 1 .. 10 ] items List of PlanIds to be filtered |
Responses
Response Schema: application/json
Array of objects (support plan details response) | |||||||||||||||||||||||||||||||||||||||||||
Array
| |||||||||||||||||||||||||||||||||||||||||||
object (pagination) Pagination | |||||||||||||||||||||||||||||||||||||||||||
|
Response samples
- 200
- 400
- 403
- 500
{- "data": [
- {
- "accountNumber": "100001",
- "ibxs": [
- "TY10",
- "TY8",
- "TY9"
], - "id": "1891931002",
- "planName": "Monthly Smart Hands Support Plan (Rollover)",
- "purchasedMinutes": 12,
- "assignedMinutes": 12,
- "remainingMinutes": 12,
- "transitionMinutes": 0,
- "startDate": "2020-11-01",
- "endDate": "2020-12-31"
}, - {
- "accountNumber": "100001",
- "ibxs": [
- "TY10",
- "TY8",
- "TY9"
], - "id": "1891931001",
- "planName": "Monthly Smart Hands Support Plan",
- "purchasedMinutes": 12,
- "assignedMinutes": 12,
- "remainingMinutes": 12,
- "transitionMinutes": 0,
- "startDate": "2020-12-01",
- "endDate": "2021-01-31"
}, - {
- "accountNumber": "100001",
- "ibxs": [
- "TY10",
- "TY8",
- "TY9"
], - "id": "1891931000",
- "planName": "Prepaid Smart Hands Support Plan",
- "purchasedMinutes": 12,
- "assignedMinutes": 12,
- "remainingMinutes": 12,
- "transitionMinutes": 0,
- "startDate": "2020-12-01",
- "endDate": "2021-12-31"
}
], - "pagination": {
- "offset": 0,
- "limit": 25,
- "total": 100,
- "next": "/supportPlans?offset=25&limit=25",
- "previous": "/supportPlans?offset=0&limit=25"
}
}