Get Subscription Overview
Get an overview of all subscriptions that authorized the application
Query Parameters
- subscriptionId uuid
Subscription id
- offset int32
Offset for paging
- limit int32
Default value:
25
Limit for paging
Header Parameters
- etag string
Etag
- 200
- 304
- 400
- 401
Successful
- text/plain
- application/json
- text/json
- Schema
- Example (from schema)
Schema
- totalCount int32
Total count of items
subscriptions object[] nullable
List of subscription information
Array [subscriptionId uuidSubscription id
parentSubscriptionId uuid nullableParent subscription id
name string nullableSubscription name
tapioId string nullableTapio id
assignedMachines object[] nullable
Assigned machines
Array [tmid string nullableTapioMachineId
deviceType DeviceTypePossible values: [
Unknown
,Machine
,SmartDevice
]Device type
deviceSubType string nullableDevice sub-type. If Device type is set to "Machine", Device sub-type will only contain one the following values: "Unknown", "Edge", "Saw", "Cnc", "Sanding", "Drilling", "Assembly", "Storing", "Stock", "Sorting", "Shipping", "PreAssembly", "Lamination", "Moulding", "Packaging", "Handling"
displayName string nullableDisplay name
manufacturerSerialNumber string nullableSerial number given to the machine by its manufacturer.
onboardingDate date-timeThe date, when the machine has been added to the subscription
equipmentGroup object
Information about a group in the context of a machine, assigned to it.
id string nullableId of the equipment group.
groupPosition int32Position of the machine within the group.
assignedApplications object[] nullable
List of assigned applications for this machine
Array [id uuidApplication id
]]subscriptionTypes string[] nullable deprecatedSubscription Types
subscriptionType string nullableSubscription Type
subscriptionFeatures string[] nullableSubscription Features
servicePartners object[] nullable
Service partners
Array [subscriptionId uuidSubscription id
name string nullableService partner name
customerNumber string nullableCustomer number
parentSubscriptionId uuid nullableParent id
providerNo string nullableProvider number
servicePartnerType ServicePartnerTypePossible values: [
MachineService
,SharpeningService
]Service partner type
]licenses object[] nullable
Licenses
Array [licenseId uuidLicense id
applicationId uuidApplication id
createdDate date-timeLicense creation date
billingStartDate date-timeBilling start date
billingInterval string nullableBilling interval
licenseCount int32License count
]equipmentGroups object[] nullable
Equipment groups
Array [id string nullableEquipment group id
parentId string nullableId of the parent equipment group, or null if there is no parent.
displayName string nullableDisplay name
groupPosition int32Position of the machine within the group
placesCount int32Number of places in the equipment group
type GroupTypePossible values: [
Group
,Warehouse
,Root
]]servicePartnerType ServicePartnerTypePossible values: [
MachineService
,SharpeningService
]Service partner type
]
{
"totalCount": 0,
"subscriptions": [
{
"subscriptionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"parentSubscriptionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "string",
"tapioId": "string",
"assignedMachines": [
{
"tmid": "string",
"deviceType": "Unknown",
"deviceSubType": "string",
"displayName": "string",
"manufacturerSerialNumber": "string",
"onboardingDate": "2024-07-03T15:23:40.197Z",
"equipmentGroup": {
"id": "string",
"groupPosition": 0
},
"assignedApplications": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
]
}
],
"subscriptionType": "string",
"subscriptionFeatures": [
"string"
],
"servicePartners": [
{
"subscriptionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "string",
"customerNumber": "string",
"parentSubscriptionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"providerNo": "string",
"servicePartnerType": "MachineService"
}
],
"licenses": [
{
"licenseId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"applicationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"createdDate": "2024-07-03T15:23:40.197Z",
"billingStartDate": "2024-07-03T15:23:40.197Z",
"billingInterval": "string",
"licenseCount": 0
}
],
"equipmentGroups": [
{
"id": "string",
"parentId": "string",
"displayName": "string",
"groupPosition": 0,
"placesCount": 0,
"type": "Group"
}
],
"servicePartnerType": "MachineService"
}
]
}
- Schema
- Example (from schema)
Schema
- totalCount int32
Total count of items
subscriptions object[] nullable
List of subscription information
Array [subscriptionId uuidSubscription id
parentSubscriptionId uuid nullableParent subscription id
name string nullableSubscription name
tapioId string nullableTapio id
assignedMachines object[] nullable
Assigned machines
Array [tmid string nullableTapioMachineId
deviceType DeviceTypePossible values: [
Unknown
,Machine
,SmartDevice
]Device type
deviceSubType string nullableDevice sub-type. If Device type is set to "Machine", Device sub-type will only contain one the following values: "Unknown", "Edge", "Saw", "Cnc", "Sanding", "Drilling", "Assembly", "Storing", "Stock", "Sorting", "Shipping", "PreAssembly", "Lamination", "Moulding", "Packaging", "Handling"
displayName string nullableDisplay name
manufacturerSerialNumber string nullableSerial number given to the machine by its manufacturer.
onboardingDate date-timeThe date, when the machine has been added to the subscription
equipmentGroup object
Information about a group in the context of a machine, assigned to it.
id string nullableId of the equipment group.
groupPosition int32Position of the machine within the group.
assignedApplications object[] nullable
List of assigned applications for this machine
Array [id uuidApplication id
]]subscriptionTypes string[] nullable deprecatedSubscription Types
subscriptionType string nullableSubscription Type
subscriptionFeatures string[] nullableSubscription Features
servicePartners object[] nullable
Service partners
Array [subscriptionId uuidSubscription id
name string nullableService partner name
customerNumber string nullableCustomer number
parentSubscriptionId uuid nullableParent id
providerNo string nullableProvider number
servicePartnerType ServicePartnerTypePossible values: [
MachineService
,SharpeningService
]Service partner type
]licenses object[] nullable
Licenses
Array [licenseId uuidLicense id
applicationId uuidApplication id
createdDate date-timeLicense creation date
billingStartDate date-timeBilling start date
billingInterval string nullableBilling interval
licenseCount int32License count
]equipmentGroups object[] nullable
Equipment groups
Array [id string nullableEquipment group id
parentId string nullableId of the parent equipment group, or null if there is no parent.
displayName string nullableDisplay name
groupPosition int32Position of the machine within the group
placesCount int32Number of places in the equipment group
type GroupTypePossible values: [
Group
,Warehouse
,Root
]]servicePartnerType ServicePartnerTypePossible values: [
MachineService
,SharpeningService
]Service partner type
]
{
"totalCount": 0,
"subscriptions": [
{
"subscriptionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"parentSubscriptionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "string",
"tapioId": "string",
"assignedMachines": [
{
"tmid": "string",
"deviceType": "Unknown",
"deviceSubType": "string",
"displayName": "string",
"manufacturerSerialNumber": "string",
"onboardingDate": "2024-07-03T15:23:40.199Z",
"equipmentGroup": {
"id": "string",
"groupPosition": 0
},
"assignedApplications": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
]
}
],
"subscriptionType": "string",
"subscriptionFeatures": [
"string"
],
"servicePartners": [
{
"subscriptionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "string",
"customerNumber": "string",
"parentSubscriptionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"providerNo": "string",
"servicePartnerType": "MachineService"
}
],
"licenses": [
{
"licenseId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"applicationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"createdDate": "2024-07-03T15:23:40.200Z",
"billingStartDate": "2024-07-03T15:23:40.200Z",
"billingInterval": "string",
"licenseCount": 0
}
],
"equipmentGroups": [
{
"id": "string",
"parentId": "string",
"displayName": "string",
"groupPosition": 0,
"placesCount": 0,
"type": "Group"
}
],
"servicePartnerType": "MachineService"
}
]
}
- Schema
- Example (from schema)
Schema
- totalCount int32
Total count of items
subscriptions object[] nullable
List of subscription information
Array [subscriptionId uuidSubscription id
parentSubscriptionId uuid nullableParent subscription id
name string nullableSubscription name
tapioId string nullableTapio id
assignedMachines object[] nullable
Assigned machines
Array [tmid string nullableTapioMachineId
deviceType DeviceTypePossible values: [
Unknown
,Machine
,SmartDevice
]Device type
deviceSubType string nullableDevice sub-type. If Device type is set to "Machine", Device sub-type will only contain one the following values: "Unknown", "Edge", "Saw", "Cnc", "Sanding", "Drilling", "Assembly", "Storing", "Stock", "Sorting", "Shipping", "PreAssembly", "Lamination", "Moulding", "Packaging", "Handling"
displayName string nullableDisplay name
manufacturerSerialNumber string nullableSerial number given to the machine by its manufacturer.
onboardingDate date-timeThe date, when the machine has been added to the subscription
equipmentGroup object
Information about a group in the context of a machine, assigned to it.
id string nullableId of the equipment group.
groupPosition int32Position of the machine within the group.
assignedApplications object[] nullable
List of assigned applications for this machine
Array [id uuidApplication id
]]subscriptionTypes string[] nullable deprecatedSubscription Types
subscriptionType string nullableSubscription Type
subscriptionFeatures string[] nullableSubscription Features
servicePartners object[] nullable
Service partners
Array [subscriptionId uuidSubscription id
name string nullableService partner name
customerNumber string nullableCustomer number
parentSubscriptionId uuid nullableParent id
providerNo string nullableProvider number
servicePartnerType ServicePartnerTypePossible values: [
MachineService
,SharpeningService
]Service partner type
]licenses object[] nullable
Licenses
Array [licenseId uuidLicense id
applicationId uuidApplication id
createdDate date-timeLicense creation date
billingStartDate date-timeBilling start date
billingInterval string nullableBilling interval
licenseCount int32License count
]equipmentGroups object[] nullable
Equipment groups
Array [id string nullableEquipment group id
parentId string nullableId of the parent equipment group, or null if there is no parent.
displayName string nullableDisplay name
groupPosition int32Position of the machine within the group
placesCount int32Number of places in the equipment group
type GroupTypePossible values: [
Group
,Warehouse
,Root
]]servicePartnerType ServicePartnerTypePossible values: [
MachineService
,SharpeningService
]Service partner type
]
{
"totalCount": 0,
"subscriptions": [
{
"subscriptionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"parentSubscriptionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "string",
"tapioId": "string",
"assignedMachines": [
{
"tmid": "string",
"deviceType": "Unknown",
"deviceSubType": "string",
"displayName": "string",
"manufacturerSerialNumber": "string",
"onboardingDate": "2024-07-03T15:23:40.203Z",
"equipmentGroup": {
"id": "string",
"groupPosition": 0
},
"assignedApplications": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
]
}
],
"subscriptionType": "string",
"subscriptionFeatures": [
"string"
],
"servicePartners": [
{
"subscriptionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "string",
"customerNumber": "string",
"parentSubscriptionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"providerNo": "string",
"servicePartnerType": "MachineService"
}
],
"licenses": [
{
"licenseId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"applicationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"createdDate": "2024-07-03T15:23:40.204Z",
"billingStartDate": "2024-07-03T15:23:40.204Z",
"billingInterval": "string",
"licenseCount": 0
}
],
"equipmentGroups": [
{
"id": "string",
"parentId": "string",
"displayName": "string",
"groupPosition": 0,
"placesCount": 0,
"type": "Group"
}
],
"servicePartnerType": "MachineService"
}
]
}
ETag matches
Bad request
- text/plain
- application/json
- text/json
- Schema
- Example (from schema)
Schema
- message string nullable
- details string[] nullable
{
"message": "string",
"details": [
"string"
]
}
- Schema
- Example (from schema)
Schema
- message string nullable
- details string[] nullable
{
"message": "string",
"details": [
"string"
]
}
- Schema
- Example (from schema)
Schema
- message string nullable
- details string[] nullable
{
"message": "string",
"details": [
"string"
]
}
Unauthorized
- text/plain
- application/json
- text/json
- Schema
- Example (from schema)
Schema
- message string nullable
- details string[] nullable
{
"message": "string",
"details": [
"string"
]
}
- Schema
- Example (from schema)
Schema
- message string nullable
- details string[] nullable
{
"message": "string",
"details": [
"string"
]
}
- Schema
- Example (from schema)
Schema
- message string nullable
- details string[] nullable
{
"message": "string",
"details": [
"string"
]
}