Download OpenAPI specification:
This is an API for accessing the Telness Tech platform, Seamless OS. It is a RESTful API that uses JSON as the data format for requests and responses. It is built on top of the OpenAPI 3.0 specification and designed for ease of use for developers who want to integrate Seamless OS into their own applications.
It provides access to a wide range of features, including authentication, configuration, customers, users, subscribers, subscriptions, orders, product catalogues, products, offerings, product groups and much more.
Go back to Telnesstech.com
Authentication endpoints for the API. These provide the ability to log in and out of the system. First, we must initiate the login process, then verify the login in order to get a token. The token can be used to authenticate other requests when needed.
The token is valid for a limited time and must be refreshed when it expires. This is done by initiating the login process again.
Initiates the login process depending on the method.
string <email> Email address of user. |
{- "email": "user@example.com"
}
{- "nonce": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "expiresAt": "2019-08-24T14:15:22Z"
}
Verifies the login process depending on the method. The login method has to correspond to the method used in the initiation process.
nonce | string Nonce received from the login initiation process. |
string <email> Email address of user. | |
pin | string PIN that the user received. |
{- "nonce": "string",
- "email": "user@example.com",
- "pin": "string"
}
{- "token": "string"
}
Check if a user exists with the email address and/or msisdn.
string <email> Email address to check if a user has. | |
msisdn | string <phone> Phone number to check if a user has. |
{- "email": "user@example.com",
- "msisdn": "string"
}
{- "exists": true,
- "description": "user recognized by email"
}
Configuration endpoints for the API. These provide access to the configuration settings for the system. This includes identity settings and product features.
List of allowed enum values for a given type
type required | string Enum: "subscription-type" "license-type" "product-category" "customer-type" The type of enum values to list |
{- "items": [
- "string"
]
}
A customer is the paying entity, the one that will get an invoice. It is the parent entity for users, subscribers and subscriptions. A customer can have multiple users, subscribers and subscriptions.
filter | string A search query to filter the entity by. |
limit | integer The maximum number of items to return. |
offset | integer The number of items to skip before starting to collect the items. |
object |
{- "items": [
- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "identity": {
- "personalNumber": "string"
}, - "name": "string",
- "customerType": "string",
- "billingMethod": "EmailInvoice",
- "invoicingEmail": "user@example.com",
- "billingAddress": { },
- "shippingAddress": { },
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "pagination": {
- "total": 0,
- "limit": 0,
- "offset": 0,
- "sort": {
- "key": "string",
- "direction": "ASC"
}
}
}
id required | string <uuid> The unique identifier for the customer. |
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "identity": {
- "personalNumber": "string"
}, - "name": "string",
- "customerType": "string",
- "billingMethod": "EmailInvoice",
- "invoicingEmail": "user@example.com",
- "billingAddress": { },
- "shippingAddress": { },
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
id required | string <uuid> The unique identifier for the customer. |
name | string The name of the customer |
string The email of the customer | |
object (Address) This is a dynamic schema that represents the address of the region where the entity is located. It changes based on regional requirements. Call /config/schemas/address for schema. |
{- "name": "string",
- "email": "string",
- "address": { }
}
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "identity": {
- "personalNumber": "string"
}, - "name": "string",
- "customerType": "string",
- "billingMethod": "EmailInvoice",
- "invoicingEmail": "user@example.com",
- "billingAddress": { },
- "shippingAddress": { },
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
code required | string Promotion code |
{- "promotion": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "discountId": "80df6fdf-c450-406e-948b-f77d4ac1cdb8",
- "code": "string",
- "discountPeriodMonths": 0,
- "validFrom": "2019-08-24T14:15:22Z",
- "validTo": "2019-08-24T14:15:22Z"
}, - "discount": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "description": "string",
- "tag": "string",
- "discountType": "UNKNOWN",
- "productOfferings": [
- {
- "productOfferingId": "string",
- "amount": -100
}
], - "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
}
customerId required | string |
startMonth | string <date> The customer ID. |
limit | integer The maximum number of items to return. |
offset | integer The number of items to skip before starting to collect the items. |
object |
[- {
- "id": 0,
- "paymentStatus": "UNKNOWN",
- "invoicingPeriod": "2019-08-24",
- "dueDate": "2019-08-24",
- "cost": 0.1,
- "invoiceUrl": "string",
- "isAutomaticallyPaid": true
}
]
A license is a permission to use a software product. It is linked to a customer and an order. It can have multiple products and is linked to a customer.
customerId required | string <uuid> The unique identifier for the customer. |
type | Array of strings (LicenseType) The type of the license. |
status | Array of strings (LicenseStatus) Items Enum: "UNKNOWN" "PENDING" "ACTIVE" "PAUSED" "CANCELLED" "BLOCKED" The status of the license. |
search | string Search term for the license. |
limit | integer The maximum number of items to return. |
offset | integer The number of items to skip before starting to collect the items. |
object |
{- "items": [
- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "type": "string",
- "status": "UNKNOWN",
- "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
- "orderId": "b3e1eced-f2bd-4d8c-9765-fbc9d1d222d5",
- "activationDate": "2019-08-24",
- "activationDateActivationId": "string",
- "cancelAt": "2019-08-24",
- "cancelAtActivationId": "d049a905-b26b-4d13-8e2c-8e1b0b8bd5e7",
- "productOfferingId": "string",
- "initialProductOfferingId": "string",
- "pendingProductOfferingId": "string",
- "pendingProductActivationId": "string",
- "updateProductAt": "2019-08-24",
- "pauseAt": "2019-08-24",
- "pauseAtActivationId": "string",
- "unpauseAt": "2019-08-24",
- "unpauseAtActivationId": "string",
- "assignedTo": {
- "pbx_user_id": "string"
}, - "details": { },
- "paymentPlan": { }
}
], - "pagination": {
- "total": 0,
- "limit": 0,
- "offset": 0,
- "sort": {
- "key": "string",
- "direction": "ASC"
}
}
}
id required | string <uuid> ID of license |
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "type": "string",
- "status": "UNKNOWN",
- "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
- "orderId": "b3e1eced-f2bd-4d8c-9765-fbc9d1d222d5",
- "activationDate": "2019-08-24",
- "activationDateActivationId": "string",
- "cancelAt": "2019-08-24",
- "cancelAtActivationId": "d049a905-b26b-4d13-8e2c-8e1b0b8bd5e7",
- "productOfferingId": "string",
- "initialProductOfferingId": "string",
- "pendingProductOfferingId": "string",
- "pendingProductActivationId": "string",
- "updateProductAt": "2019-08-24",
- "pauseAt": "2019-08-24",
- "pauseAtActivationId": "string",
- "unpauseAt": "2019-08-24",
- "unpauseAtActivationId": "string",
- "assignedTo": {
- "pbx_user_id": "string"
}, - "details": { },
- "paymentPlan": { }
}
id required | string <uuid> ID of license |
The license product offering change request
productOfferingId required | string The ID of the product offering to change to. |
updateAt | string <date> The date when the license should be updated. If not provided, the license will be updated immediately. |
addBindingPeriod | boolean If true, the license will be updated with an additional binding period |
{- "productOfferingId": "string",
- "updateAt": "2019-08-24",
- "addBindingPeriod": true
}
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "type": "string",
- "status": "UNKNOWN",
- "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
- "orderId": "b3e1eced-f2bd-4d8c-9765-fbc9d1d222d5",
- "activationDate": "2019-08-24",
- "activationDateActivationId": "string",
- "cancelAt": "2019-08-24",
- "cancelAtActivationId": "d049a905-b26b-4d13-8e2c-8e1b0b8bd5e7",
- "productOfferingId": "string",
- "initialProductOfferingId": "string",
- "pendingProductOfferingId": "string",
- "pendingProductActivationId": "string",
- "updateProductAt": "2019-08-24",
- "pauseAt": "2019-08-24",
- "pauseAtActivationId": "string",
- "unpauseAt": "2019-08-24",
- "unpauseAtActivationId": "string",
- "assignedTo": {
- "pbx_user_id": "string"
}, - "details": { },
- "paymentPlan": { }
}
id required | string <uuid> ID of license |
The license pause request
pauseAt | string <date> The date when the license should be paused. If not provided, the license will be paused immediately. |
{- "pauseAt": "2019-08-24"
}
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "type": "string",
- "status": "UNKNOWN",
- "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
- "orderId": "b3e1eced-f2bd-4d8c-9765-fbc9d1d222d5",
- "activationDate": "2019-08-24",
- "activationDateActivationId": "string",
- "cancelAt": "2019-08-24",
- "cancelAtActivationId": "d049a905-b26b-4d13-8e2c-8e1b0b8bd5e7",
- "productOfferingId": "string",
- "initialProductOfferingId": "string",
- "pendingProductOfferingId": "string",
- "pendingProductActivationId": "string",
- "updateProductAt": "2019-08-24",
- "pauseAt": "2019-08-24",
- "pauseAtActivationId": "string",
- "unpauseAt": "2019-08-24",
- "unpauseAtActivationId": "string",
- "assignedTo": {
- "pbx_user_id": "string"
}, - "details": { },
- "paymentPlan": { }
}
id required | string <uuid> ID of license |
The license resumse request
resumeAt | string <date> The date when the license should be resumed. If not provided, the license will be resumed immediately. |
{- "resumeAt": "2019-08-24"
}
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "type": "string",
- "status": "UNKNOWN",
- "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
- "orderId": "b3e1eced-f2bd-4d8c-9765-fbc9d1d222d5",
- "activationDate": "2019-08-24",
- "activationDateActivationId": "string",
- "cancelAt": "2019-08-24",
- "cancelAtActivationId": "d049a905-b26b-4d13-8e2c-8e1b0b8bd5e7",
- "productOfferingId": "string",
- "initialProductOfferingId": "string",
- "pendingProductOfferingId": "string",
- "pendingProductActivationId": "string",
- "updateProductAt": "2019-08-24",
- "pauseAt": "2019-08-24",
- "pauseAtActivationId": "string",
- "unpauseAt": "2019-08-24",
- "unpauseAtActivationId": "string",
- "assignedTo": {
- "pbx_user_id": "string"
}, - "details": { },
- "paymentPlan": { }
}
id required | string <uuid> ID of license |
The license cancellation request
cancelAt | string <date> The date when the license should be canceled. If not provided, the license will be canceled immediately. If the license has a binding period, the license will be canceled at the end of the binding period. |
{- "cancelAt": "2019-08-24"
}
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "type": "string",
- "status": "UNKNOWN",
- "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
- "orderId": "b3e1eced-f2bd-4d8c-9765-fbc9d1d222d5",
- "activationDate": "2019-08-24",
- "activationDateActivationId": "string",
- "cancelAt": "2019-08-24",
- "cancelAtActivationId": "d049a905-b26b-4d13-8e2c-8e1b0b8bd5e7",
- "productOfferingId": "string",
- "initialProductOfferingId": "string",
- "pendingProductOfferingId": "string",
- "pendingProductActivationId": "string",
- "updateProductAt": "2019-08-24",
- "pauseAt": "2019-08-24",
- "pauseAtActivationId": "string",
- "unpauseAt": "2019-08-24",
- "unpauseAtActivationId": "string",
- "assignedTo": {
- "pbx_user_id": "string"
}, - "details": { },
- "paymentPlan": { }
}
A number is a phone number that can be provisioned for a customer. It is linked to a subscription.
types | Array of strings (NumberType) Items Enum: "CELL" "FIXED" "DATA" "M2M" "UNKNOWN" |
count required | integer <int32> >= 1 The quantity of numbers to lease |
{- "types": [
- "CELL"
], - "count": 1
}
{- "numbers": [
- {
- "msisdn": "string",
- "type": "CELL",
- "status": "AVAILABLE",
- "grade": 0,
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "availableAt": "2019-08-24T14:15:22Z",
- "reservedAt": "2019-08-24T14:15:22Z",
- "expiresAt": "2019-08-24T14:15:22Z"
}
], - "leaseToken": "string"
}
msisdn required | string The msisdn to check portin eligibility for |
{- "msisdn": "string"
}
{- "result": true
}
An order is a request to purchase a product offering or several. This is how new subscriptions and products are purchased.
customerId required | string <uuid> The unique identifier for the customer. |
status | Array of strings Items Enum: "UNVERIFIED" "PENDING" "FAILURE" "APPROVED" "REJECTED" The status of the order. |
limit | integer The maximum number of items to return. |
offset | integer The number of items to skip before starting to collect the items. |
object |
{- "items": [
- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "status": "UNVERIFIED",
- "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
- "details": {
- "subscriptionId": "d079718b-ff63-45dd-947b-4950c023750f",
- "productOfferingId": "string"
}, - "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "fulfilledAt": "2019-08-24T14:15:22Z"
}
], - "pagination": {
- "total": 0,
- "limit": 0,
- "offset": 0,
- "sort": {
- "key": "string",
- "direction": "ASC"
}
}
}
customerType | string (CustomerType) The type of customer. See /config/enums/customer-type for valid values. |
Array of objects (Subscribers) | |
Array of objects (Licenses) | |
required | object The person making the order. |
required | object (Billing) Billing information representing the paying entity. |
object (Shipping) Information used for shipping. | |
promotionCode | string (PromotionCode) The promotion code to apply to the order. |
customerTags | Array of strings The tags that would apply to a customer created by the order. See /config/tags for valid keys. |
{- "customerType": "string",
- "subscribers": [
- {
- "name": "string",
- "email": "user@example.com",
- "msisdn": "string",
- "productOfferingId": "string",
- "esim": true,
- "icc": "string",
- "imei": "string",
- "leaseToken": "string",
- "transferFromIdentity": { },
- "transferFromRequest": { },
- "activateAt": "2019-08-24T14:15:22Z",
- "extraDataProductOfferingIds": [
- "string"
], - "productOfferingAddonIds": [
- "string"
], - "address": { },
- "emergencyAddress": { },
- "tags": [
- "string"
]
}
], - "licenses": [
- {
- "productOfferingId": "string",
- "activateAt": "2019-08-24T14:15:22Z"
}
], - "orderedBy": {
- "email": "user@example.com",
- "identity": {
- "personalNumber": "string"
}, - "msisdn": "string",
- "name": "string"
}, - "billing": {
- "name": "string",
- "email": "user@example.com",
- "identity": {
- "personalNumber": "string"
}, - "address": { }
}, - "shipping": {
- "name": "string",
- "address": { }
}, - "promotionCode": "string",
- "customerTags": [
- "string"
]
}
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "status": "UNVERIFIED",
- "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
- "details": {
- "subscriptionId": "d079718b-ff63-45dd-947b-4950c023750f",
- "productOfferingId": "string"
}, - "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "fulfilledAt": "2019-08-24T14:15:22Z"
}
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "status": "UNVERIFIED",
- "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
- "details": {
- "subscriptionId": "d079718b-ff63-45dd-947b-4950c023750f",
- "productOfferingId": "string"
}, - "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "fulfilledAt": "2019-08-24T14:15:22Z"
}
customerId required | string <uuid> The ID of the customer to create the order for. |
Array of objects (Subscribers) | |
Array of objects (Licenses) | |
object (Shipping) Information used for shipping. | |
promotionCode | string (PromotionCode) The promotion code to apply to the order. |
{- "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
- "subscribers": [
- {
- "name": "string",
- "email": "user@example.com",
- "msisdn": "string",
- "productOfferingId": "string",
- "esim": true,
- "icc": "string",
- "imei": "string",
- "leaseToken": "string",
- "transferFromIdentity": { },
- "transferFromRequest": { },
- "activateAt": "2019-08-24T14:15:22Z",
- "extraDataProductOfferingIds": [
- "string"
], - "productOfferingAddonIds": [
- "string"
], - "address": { },
- "emergencyAddress": { },
- "tags": [
- "string"
]
}
], - "licenses": [
- {
- "productOfferingId": "string",
- "activateAt": "2019-08-24T14:15:22Z"
}
], - "shipping": {
- "name": "string",
- "address": { }
}, - "promotionCode": "string"
}
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "status": "UNVERIFIED",
- "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
- "details": {
- "subscriptionId": "d079718b-ff63-45dd-947b-4950c023750f",
- "productOfferingId": "string"
}, - "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "fulfilledAt": "2019-08-24T14:15:22Z"
}
customerType required | string (CustomerType) The type of customer. See /config/enums/customer-type for valid values. |
required | object (CalculatePriceDetailsOrderedBy) The person making the order. |
object (CalculatePriceDetailsBilling) Billing information representing the paying entity. | |
Array of objects (CalculatePriceDetailsSubscriber) | |
Array of objects (CalculatePriceDetailsLicense) | |
promotionCode | string (PromotionCode) The promotion code to apply to the order. |
{- "customerType": "string",
- "orderedBy": {
- "email": "user@example.com",
- "identity": {
- "personalNumber": "string"
}
}, - "billing": {
- "identity": {
- "personalNumber": "string"
}, - "address": { }
}, - "subscribers": [
- {
- "productOfferingId": "string",
- "activateAt": "2019-08-24T14:15:22Z",
- "extraDataProductOfferingIds": [
- "string"
], - "productOfferingAddonIds": [
- "string"
]
}
], - "licenses": [
- {
- "productOfferingId": "string",
- "activateAt": "2019-08-24T14:15:22Z"
}
], - "promotionCode": "string"
}
{- "checkoutTotal": {
- "gross": 0,
- "net": 0,
- "vat": 0,
- "date": "2019-08-24"
}, - "initialInvoiceTotal": {
- "gross": 0,
- "net": 0,
- "vat": 0,
- "date": "2019-08-24"
}, - "recurringInvoiceTotal": {
- "gross": 0,
- "net": 0,
- "vat": 0,
- "date": "2019-08-24"
}, - "items": [
- {
- "productOfferingId": "string",
- "checkoutPrice": {
- "gross": 0,
- "net": 0,
- "vat": 0,
- "date": "2019-08-24"
}, - "initialInvoicePrice": {
- "gross": 0,
- "net": 0,
- "vat": 0,
- "date": "2019-08-24"
}, - "recurringInvoicePrice": {
- "gross": 0,
- "net": 0,
- "vat": 0,
- "date": "2019-08-24"
}
}
]
}
customerType required | string (CustomerType) The type of customer. See /config/enums/customer-type for valid values. |
customerId required | string <uuid> The ID of the customer making the order. |
Array of objects (CalculatePriceDetailsSubscriber) | |
Array of objects (CalculatePriceDetailsLicense) | |
promotionCode | string (PromotionCode) The promotion code to apply to the order. |
{- "customerType": "string",
- "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
- "subscribers": [
- {
- "productOfferingId": "string",
- "activateAt": "2019-08-24T14:15:22Z",
- "extraDataProductOfferingIds": [
- "string"
], - "productOfferingAddonIds": [
- "string"
]
}
], - "licenses": [
- {
- "productOfferingId": "string",
- "activateAt": "2019-08-24T14:15:22Z"
}
], - "promotionCode": "string"
}
{- "checkoutTotal": {
- "gross": 0,
- "net": 0,
- "vat": 0,
- "date": "2019-08-24"
}, - "initialInvoiceTotal": {
- "gross": 0,
- "net": 0,
- "vat": 0,
- "date": "2019-08-24"
}, - "recurringInvoiceTotal": {
- "gross": 0,
- "net": 0,
- "vat": 0,
- "date": "2019-08-24"
}, - "items": [
- {
- "productOfferingId": "string",
- "checkoutPrice": {
- "gross": 0,
- "net": 0,
- "vat": 0,
- "date": "2019-08-24"
}, - "initialInvoicePrice": {
- "gross": 0,
- "net": 0,
- "vat": 0,
- "date": "2019-08-24"
}, - "recurringInvoicePrice": {
- "gross": 0,
- "net": 0,
- "vat": 0,
- "date": "2019-08-24"
}
}
]
}
A payment is a financial transaction that can be made by a customer. It is linked to an order.
subscriptionId required | string The subscription ID that is being topped-up. |
offeringId required | string The offering ID that is being paid for. |
{- "subscriptionId": "string",
- "offeringId": "string"
}
{- "id": "string",
- "clientSecret": "string",
- "publishableKey": "string"
}
orderId required | string The order ID that is being payed. |
{- "orderId": "string"
}
{- "id": "string",
- "clientSecret": "string",
- "publishableKey": "string"
}
orderId | string OrderID of the order to be verified. |
{- "orderId": "string"
}
true
orderId required | string The order ID that needs to be verified. |
returnUrl required | string The URL to redirect to after the payment is completed. |
{- "orderId": "string",
- "returnUrl": "string"
}
{- "clientSecret": "string",
- "id": "string",
- "publishableKey": "string"
}
checkoutId required | string The stripe checkout session ID. |
{- "checkoutId": "string"
}
{- "status": "string",
- "id": "string"
}
A product catalogue defines which product offerings a customer has access to. It is linked to a customer and can have multiple product offerings.
filter | string A search query to filter the entity by. |
limit | integer The maximum number of items to return. |
offset | integer The number of items to skip before starting to collect the items. |
object |
{- "items": [
- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "name": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "description": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "productGroups": [
- {
- "id": "string",
- "name": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "description": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "category": "string",
- "internalDescription": "string"
}
], - "productOfferings": [
- {
- "id": "string",
- "externalReference": "string",
- "name": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "description": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "price": {
- "cost": 0.1,
- "discount": 0.1,
- "priceType": "UNKNOWN",
- "unitAmount": 0,
- "boundMonths": 0
}, - "product": {
- "id": "string",
- "category": "string"
}, - "groupId": "string",
- "customerType": "string",
- "isAddon": true,
- "addonCategories": [
- "string"
], - "richTextContent": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "isArchived": true,
- "internalDescription": "string",
}
], - "extendsDefault": true
}
], - "pagination": {
- "total": 0,
- "limit": 0,
- "offset": 0,
- "sort": {
- "key": "string",
- "direction": "ASC"
}
}
}
required | object (LocalizedString) A string that can be translated to different languages. |
required | object (LocalizedString) A string that can be translated to different languages. |
productOfferingIds required | Array of strings |
extendsDefault required | boolean Whether the product catalogue extends the default product catalogue. |
{- "name": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "description": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "productOfferingIds": [
- "string"
], - "extendsDefault": true
}
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "name": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "description": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "productGroups": [
- {
- "id": "string",
- "name": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "description": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "category": "string",
- "internalDescription": "string"
}
], - "productOfferings": [
- {
- "id": "string",
- "externalReference": "string",
- "name": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "description": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "price": {
- "cost": 0.1,
- "discount": 0.1,
- "priceType": "UNKNOWN",
- "unitAmount": 0,
- "boundMonths": 0
}, - "product": {
- "id": "string",
- "category": "string"
}, - "groupId": "string",
- "customerType": "string",
- "isAddon": true,
- "addonCategories": [
- "string"
], - "richTextContent": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "isArchived": true,
- "internalDescription": "string",
}
], - "extendsDefault": true
}
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "name": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "description": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "productGroups": [
- {
- "id": "string",
- "name": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "description": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "category": "string",
- "internalDescription": "string"
}
], - "productOfferings": [
- {
- "id": "string",
- "externalReference": "string",
- "name": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "description": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "price": {
- "cost": 0.1,
- "discount": 0.1,
- "priceType": "UNKNOWN",
- "unitAmount": 0,
- "boundMonths": 0
}, - "product": {
- "id": "string",
- "category": "string"
}, - "groupId": "string",
- "customerType": "string",
- "isAddon": true,
- "addonCategories": [
- "string"
], - "richTextContent": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "isArchived": true,
- "internalDescription": "string",
}
], - "extendsDefault": true
}
id required | string <uuid> ID of product catalogue |
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "name": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "description": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "productGroups": [
- {
- "id": "string",
- "name": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "description": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "category": "string",
- "internalDescription": "string"
}
], - "productOfferings": [
- {
- "id": "string",
- "externalReference": "string",
- "name": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "description": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "price": {
- "cost": 0.1,
- "discount": 0.1,
- "priceType": "UNKNOWN",
- "unitAmount": 0,
- "boundMonths": 0
}, - "product": {
- "id": "string",
- "category": "string"
}, - "groupId": "string",
- "customerType": "string",
- "isAddon": true,
- "addonCategories": [
- "string"
], - "richTextContent": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "isArchived": true,
- "internalDescription": "string",
}
], - "extendsDefault": true
}
id required | string <uuid> ID of product catalogue |
required | object (LocalizedString) A string that can be translated to different languages. |
required | object (LocalizedString) A string that can be translated to different languages. |
productOfferingIds required | Array of strings |
extendsDefault required | boolean Whether the product catalogue extends the default product catalogue. |
{- "name": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "description": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "productOfferingIds": [
- "string"
], - "extendsDefault": true
}
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "name": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "description": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "productGroups": [
- {
- "id": "string",
- "name": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "description": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "category": "string",
- "internalDescription": "string"
}
], - "productOfferings": [
- {
- "id": "string",
- "externalReference": "string",
- "name": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "description": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "price": {
- "cost": 0.1,
- "discount": 0.1,
- "priceType": "UNKNOWN",
- "unitAmount": 0,
- "boundMonths": 0
}, - "product": {
- "id": "string",
- "category": "string"
}, - "groupId": "string",
- "customerType": "string",
- "isAddon": true,
- "addonCategories": [
- "string"
], - "richTextContent": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "isArchived": true,
- "internalDescription": "string",
}
], - "extendsDefault": true
}
A product group shows what other product offerings it can be upgraded / downgraded to. It is linked to a product offering.
productCategory | string (ProductCategory) The category to filter by. |
[- {
- "id": "string",
- "name": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "description": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "category": "string",
- "internalDescription": "string"
}
]
required | object (LocalizedString) A string that can be translated to different languages. |
required | object (LocalizedString) A string that can be translated to different languages. |
internalDescription | string The internal description of the product group. This is used for internal purposes only. |
category required | string (ProductCategory) The category of the product. See /config/enums/product-category for valid values |
{- "name": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "description": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "internalDescription": "string",
- "category": "string"
}
{- "id": "string",
- "name": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "description": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "category": "string",
- "internalDescription": "string"
}
{- "id": "string",
- "name": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "description": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "category": "string",
- "internalDescription": "string"
}
id required | string ID of product group |
object (LocalizedString) A string that can be translated to different languages. | |
object (LocalizedString) A string that can be translated to different languages. | |
internalDescription | string The internal description of the product group. This is used for internal purposes only. |
{- "name": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "description": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "internalDescription": "string"
}
{- "id": "string",
- "name": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "description": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "category": "string",
- "internalDescription": "string"
}
A product offering is a product combined with a price that is offered to customers. It is linked to a product catalogue.
productCategory | string (ProductCategory) The category to filter by. |
filter | string A search query to filter the entity by. |
customerType | string (CustomerType) The type of customer. |
limit | integer The maximum number of items to return. |
offset | integer The number of items to skip before starting to collect the items. |
object |
{- "items": [
- {
- "id": "string",
- "externalReference": "string",
- "name": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "description": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "price": {
- "cost": 0.1,
- "discount": 0.1,
- "priceType": "UNKNOWN",
- "unitAmount": 0,
- "boundMonths": 0
}, - "product": {
- "id": "string",
- "category": "string"
}, - "groupId": "string",
- "customerType": "string",
- "isAddon": true,
- "addonCategories": [
- "string"
], - "richTextContent": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "isArchived": true,
- "internalDescription": "string",
}
], - "pagination": {
- "total": 0,
- "limit": 0,
- "offset": 0,
- "sort": {
- "key": "string",
- "direction": "ASC"
}
}
}
required | object (LocalizedString) A string that can be translated to different languages. |
object (LocalizedString) A string that can be translated to different languages. | |
productId required | string The ID of the product |
groupId required | string The ID of the group |
cost required | number <double> The cost of the product offering |
discount required | number <double> The discount of the product offering |
boundMonths required | integer <int32> The number of months the product offering is bound to |
invoicingDescription required | string The invoicing description of the product offering. |
internalDescription | string The internal description of the product offering. This is used for internal purposes only. |
customerType required | string (CustomerType) The type of customer. See /config/enums/customer-type for valid values. |
{- "name": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "description": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "productId": "string",
- "groupId": "string",
- "cost": 0.1,
- "discount": 0.1,
- "boundMonths": 0,
- "invoicingDescription": "string",
- "internalDescription": "string",
- "customerType": "string"
}
{- "id": "string",
- "externalReference": "string",
- "name": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "description": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "price": {
- "cost": 0.1,
- "discount": 0.1,
- "priceType": "UNKNOWN",
- "unitAmount": 0,
- "boundMonths": 0
}, - "product": {
- "id": "string",
- "category": "string"
}, - "groupId": "string",
- "customerType": "string",
- "isAddon": true,
- "addonCategories": [
- "string"
], - "richTextContent": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "isArchived": true,
- "internalDescription": "string",
}
{- "id": "string",
- "externalReference": "string",
- "name": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "description": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "price": {
- "cost": 0.1,
- "discount": 0.1,
- "priceType": "UNKNOWN",
- "unitAmount": 0,
- "boundMonths": 0
}, - "product": {
- "id": "string",
- "category": "string"
}, - "groupId": "string",
- "customerType": "string",
- "isAddon": true,
- "addonCategories": [
- "string"
], - "richTextContent": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "isArchived": true,
- "internalDescription": "string",
}
id required | string ID of product offering |
object (LocalizedString) A string that can be translated to different languages. | |
object (LocalizedString) A string that can be translated to different languages. | |
groupId | string The group of the product offering. |
internalDescription | string The internal description of the product offering. This is used for internal purposes only. |
{- "name": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "description": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "groupId": "string",
- "internalDescription": "string"
}
{- "id": "string",
- "externalReference": "string",
- "name": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "description": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "price": {
- "cost": 0.1,
- "discount": 0.1,
- "priceType": "UNKNOWN",
- "unitAmount": 0,
- "boundMonths": 0
}, - "product": {
- "id": "string",
- "category": "string"
}, - "groupId": "string",
- "customerType": "string",
- "isAddon": true,
- "addonCategories": [
- "string"
], - "richTextContent": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "isArchived": true,
- "internalDescription": "string",
}
id required | string ID of product offering |
customerId required | string The ID of the customer |
{- "customerId": "string"
}
{- "productOfferingId": "string",
- "grossPrice": 0.1,
- "netPrice": 0.1,
- "vat": 0.1
}
A subscriber is a user that has a subscription. It can have multiple subscriptions and is linked to a customer.
customerId required | string <uuid> The unique identifier for the customer. |
limit | integer The maximum number of items to return. |
offset | integer The number of items to skip before starting to collect the items. |
object |
{- "items": [
- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "name": "string",
- "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
- "subscriptionIds": [
- "497f6eca-6276-4993-bfeb-53cbbbba6f08"
], - "email": "user@example.com",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "pagination": {
- "total": 0,
- "limit": 0,
- "offset": 0,
- "sort": {
- "key": "string",
- "direction": "ASC"
}
}
}
subscriberIds required | Array of strings <uuid> [ items <uuid > ] The unique identifiers for the subscribers. |
customerId required | string <uuid> The unique identifier for the customer. |
{- "items": [
- {
- "subscriberId": "96d0a1b8-7f77-4d5c-847e-2afd90ed23b3",
- "usage": {
- "data": {
- "remaining": 0,
- "limit": 0
}, - "topup": {
- "remaining": 0,
- "limit": 0
}, - "callCount": 0,
- "callSeconds": 0,
- "smsCount": 0,
- "updatedAt": "2019-08-24T14:15:22Z"
}
}
]
}
id required | string <uuid> ID of subscriber |
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "name": "string",
- "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
- "subscriptionIds": [
- "497f6eca-6276-4993-bfeb-53cbbbba6f08"
], - "email": "user@example.com",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
id required | string <uuid> ID of subscriber |
string <email> The email of the subscriber | |
name | string The name of the subscriber |
{- "email": "user@example.com",
- "name": "string"
}
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "name": "string",
- "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
- "subscriptionIds": [
- "497f6eca-6276-4993-bfeb-53cbbbba6f08"
], - "email": "user@example.com",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
id required | string <uuid> ID of subscriber |
{- "data": {
- "remaining": 0,
- "limit": 0
}, - "topup": {
- "remaining": 0,
- "limit": 0
}, - "callCount": 0,
- "callSeconds": 0,
- "smsCount": 0,
- "updatedAt": "2019-08-24T14:15:22Z"
}
A subscription is a number to be provisioned for a customer. It has a subscriber and a product offering. It can have multiple orders and is linked to a customer.
customerId required | string <uuid> The unique identifier for the customer. |
status | Array of strings (SubscriptionStatus) Items Enum: "UNKNOWN" "PENDING" "ACTIVATED" "BLOCKED" "CANCELLED" "PAUSED" The subscription status. |
type | Array of strings (SubscriptionType) The subscription type. |
limit | integer The maximum number of items to return. |
offset | integer The number of items to skip before starting to collect the items. |
object |
{- "items": [
- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "status": "UNKNOWN",
- "pendingStatus": "UNKNOWN",
- "type": "string",
- "msisdn": "string",
- "msisdnPort": "string",
- "msisdnPending": "string",
- "msisdnTemporary": "string",
- "puk": "string",
- "icc": "string",
- "imsi": "string",
- "esim": true,
- "subscriberId": "string",
- "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
- "productOfferingId": "string",
- "activatedAt": "2019-08-24T14:15:22Z",
- "cancelledAt": "2019-08-24T14:15:22Z",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "property1": "string",
- "property2": "string"
}
], - "pagination": {
- "total": 0,
- "limit": 0,
- "offset": 0,
- "sort": {
- "key": "string",
- "direction": "ASC"
}
}
}
subscriptionIds required | Array of strings <uuid> [ items <uuid > ] |
{- "subscriptionIds": [
- "1aba6ca9-df01-45ba-9922-34f164485251"
]
}
{- "items": [
- {
- "subscriptionId": "1aba6ca9-df01-45ba-9922-34f164485251",
- "productOfferingId": "91edd566-7c4c-4cfa-9a62-922c098c178c",
- "cost": 100,
- "basePrice": 120,
- "basePriceDiscount": 20,
- "discounts": [
- {
- "type": "FIXED",
- "amount": -15,
- "tag": "SUMMER15"
}, - {
- "type": "FIXED",
- "amount": -5,
- "tag": "5FORFRIENDS"
}
]
}
]
}
id required | string <uuid> ID of subscription |
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "status": "UNKNOWN",
- "pendingStatus": "UNKNOWN",
- "type": "string",
- "msisdn": "string",
- "msisdnPort": "string",
- "msisdnPending": "string",
- "msisdnTemporary": "string",
- "puk": "string",
- "icc": "string",
- "imsi": "string",
- "esim": true,
- "subscriberId": "string",
- "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
- "productOfferingId": "string",
- "activatedAt": "2019-08-24T14:15:22Z",
- "cancelledAt": "2019-08-24T14:15:22Z",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "property1": "string",
- "property2": "string"
}
id required | string <uuid> ID of subscription |
productOfferingId required | string The unique identifier for the product offering. |
{- "productOfferingId": "string"
}
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "status": "UNKNOWN",
- "pendingStatus": "UNKNOWN",
- "type": "string",
- "msisdn": "string",
- "msisdnPort": "string",
- "msisdnPending": "string",
- "msisdnTemporary": "string",
- "puk": "string",
- "icc": "string",
- "imsi": "string",
- "esim": true,
- "subscriberId": "string",
- "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
- "productOfferingId": "string",
- "activatedAt": "2019-08-24T14:15:22Z",
- "cancelledAt": "2019-08-24T14:15:22Z",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "property1": "string",
- "property2": "string"
}
id required | string <uuid> ID of subscription |
{- "items": [
- {
- "type": "string",
- "allowed": true,
- "productOfferingIds": [
- "string"
], - "groupId": "string"
}
]
}
id required | string <uuid> ID of subscription |
pauseAt | string <date> The date when the subscription should be paused. If not provided, the subscription will be paused next day. |
{- "pauseAt": "2019-08-24"
}
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "status": "UNKNOWN",
- "pendingStatus": "UNKNOWN",
- "type": "string",
- "msisdn": "string",
- "msisdnPort": "string",
- "msisdnPending": "string",
- "msisdnTemporary": "string",
- "puk": "string",
- "icc": "string",
- "imsi": "string",
- "esim": true,
- "subscriberId": "string",
- "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
- "productOfferingId": "string",
- "activatedAt": "2019-08-24T14:15:22Z",
- "cancelledAt": "2019-08-24T14:15:22Z",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "property1": "string",
- "property2": "string"
}
id required | string <uuid> ID of subscription |
resumeAt | string <date> The date when the subscription should be resumed. If not provided, the subscription will be resumed immediately. |
{- "resumeAt": "2019-08-24"
}
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "status": "UNKNOWN",
- "pendingStatus": "UNKNOWN",
- "type": "string",
- "msisdn": "string",
- "msisdnPort": "string",
- "msisdnPending": "string",
- "msisdnTemporary": "string",
- "puk": "string",
- "icc": "string",
- "imsi": "string",
- "esim": true,
- "subscriberId": "string",
- "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
- "productOfferingId": "string",
- "activatedAt": "2019-08-24T14:15:22Z",
- "cancelledAt": "2019-08-24T14:15:22Z",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "property1": "string",
- "property2": "string"
}
id required | string <uuid> ID of subscription |
required | CancelNextDay (object) or CancelAtBeginningOfNextMonth (object) or CancelAtDate (object) The date when the subscription should be canceled. If not provided, the subscription will be canceled next day. |
churn | string Enum: "BETTER_DEAL_PRICE" "NOT_HAPPY_MISSING_FUNCTIONS" "NOT_HAPPY_COVERAGE_SLA" "NOT_HAPPY_COMPLEX_ADMIN" "NOT_HAPPY_SUPPORT_ENGAGEMENT" "FRAUD" "FRAUD_ATTEMPT" "TEST_OR_MARKETING" "NO_NEED" "WRONG_ORDER" "OTHER" A standardized reason for the cancellation. This is used for reporting and analysis purposes. If OTHER is provided, please also provide a comment. |
comment | string Optional comment from the user about the cancellation. |
{- "cancelAt": {
- "nextDay": true
}, - "churn": "BETTER_DEAL_PRICE",
- "comment": "string"
}
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "status": "UNKNOWN",
- "pendingStatus": "UNKNOWN",
- "type": "string",
- "msisdn": "string",
- "msisdnPort": "string",
- "msisdnPending": "string",
- "msisdnTemporary": "string",
- "puk": "string",
- "icc": "string",
- "imsi": "string",
- "esim": true,
- "subscriberId": "string",
- "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
- "productOfferingId": "string",
- "activatedAt": "2019-08-24T14:15:22Z",
- "cancelledAt": "2019-08-24T14:15:22Z",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "property1": "string",
- "property2": "string"
}
id required | string <uuid> ID of subscription |
productOfferingId required | string The product offering id of the topup option |
{- "productOfferingId": "string"
}
{- "response": "string"
}
This endpoint is deprecated, use /subscriptions/{id}/topups instead
id required | string <uuid> ID of subscription |
{- "topupAllowed": true,
- "topupOptions": [
- "string"
]
}
This endpoint is deprecated, use /subscriptions/{id}/topups instead
id required | string <uuid> ID of subscription |
{- "monetaryTopupAllowed": true,
- "monetaryTopupOptions": [
- "string"
]
}
id required | string <uuid> ID of subscription |
{- "pendingProductOffering": {
- "id": "string",
- "externalReference": "string",
- "name": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "description": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "price": {
- "cost": 0.1,
- "discount": 0.1,
- "priceType": "UNKNOWN",
- "unitAmount": 0,
- "boundMonths": 0
}, - "product": {
- "id": "string",
- "category": "string"
}, - "groupId": "string",
- "customerType": "string",
- "isAddon": true,
- "addonCategories": [
- "string"
], - "richTextContent": {
- "en": "string",
- "se": "string",
- "pl": "string"
}, - "isArchived": true,
- "internalDescription": "string",
}, - "activateAt": "2019-08-24T14:15:22Z"
}
id required | string <uuid> ID of subscription |
{- "items": [
- {
- "id": "string",
- "changeSchedule": "INSTANT",
- "changeScheduleDate": "2019-08-24"
}
]
}
id required | string <uuid> ID of subscription |
{- "items": [
- {
- "id": "string",
- "groupId": "string",
- "status": "PENDING",
- "cancelAt": "2019-08-24T14:15:22Z"
}
]
}
id required | string <uuid> ID of subscription |
productOfferingAddonId required | string ID of product offering addon |
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "status": "UNVERIFIED",
- "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
- "details": {
- "subscriptionId": "d079718b-ff63-45dd-947b-4950c023750f",
- "productOfferingId": "string"
}, - "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "fulfilledAt": "2019-08-24T14:15:22Z"
}
id required | string <uuid> ID of subscription |
productOfferingAddonId required | string ID of product offering addon |
{- "licenses": [
- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "type": "string",
- "status": "UNKNOWN",
- "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
- "orderId": "b3e1eced-f2bd-4d8c-9765-fbc9d1d222d5",
- "activationDate": "2019-08-24",
- "activationDateActivationId": "string",
- "cancelAt": "2019-08-24",
- "cancelAtActivationId": "d049a905-b26b-4d13-8e2c-8e1b0b8bd5e7",
- "productOfferingId": "string",
- "initialProductOfferingId": "string",
- "pendingProductOfferingId": "string",
- "pendingProductActivationId": "string",
- "updateProductAt": "2019-08-24",
- "pauseAt": "2019-08-24",
- "pauseAtActivationId": "string",
- "unpauseAt": "2019-08-24",
- "unpauseAtActivationId": "string",
- "assignedTo": {
- "pbx_user_id": "string"
}, - "details": { },
- "paymentPlan": { }
}
]
}
id required | string <uuid> ID of subscription |
productOfferingAddonId required | string ID of product offering addon |
{- "licenses": [
- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "type": "string",
- "status": "UNKNOWN",
- "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
- "orderId": "b3e1eced-f2bd-4d8c-9765-fbc9d1d222d5",
- "activationDate": "2019-08-24",
- "activationDateActivationId": "string",
- "cancelAt": "2019-08-24",
- "cancelAtActivationId": "d049a905-b26b-4d13-8e2c-8e1b0b8bd5e7",
- "productOfferingId": "string",
- "initialProductOfferingId": "string",
- "pendingProductOfferingId": "string",
- "pendingProductActivationId": "string",
- "updateProductAt": "2019-08-24",
- "pauseAt": "2019-08-24",
- "pauseAtActivationId": "string",
- "unpauseAt": "2019-08-24",
- "unpauseAtActivationId": "string",
- "assignedTo": {
- "pbx_user_id": "string"
}, - "details": { },
- "paymentPlan": { }
}
]
}
customerId required | string <uuid> The unique identifier for the customer. |
{- "items": [
- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "identity": {
- "personalNumber": "string"
}, - "name": "string",
- "role": "NOBODY",
- "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
- "customerIds": [
- "497f6eca-6276-4993-bfeb-53cbbbba6f08"
], - "email": "user@example.com",
- "msisdn": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
], - "pagination": {
- "total": 0,
- "limit": 0,
- "offset": 0,
- "sort": {
- "key": "string",
- "direction": "ASC"
}
}
}
name | string The name of the user |
customerId | string <uuid> The ID of the customer |
role | string Enum: "NOBODY" "MANAGER" "ADMIN" Role of the user. |
string The email of the user. A valid email address should be in the format example@domain.com | |
msisdn | string The phone number of the user. It must be in international format, starting with a '+' followed by the country code and the subscriber number, e.g. +123 4567890 |
{- "name": "string",
- "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
- "role": "NOBODY",
- "email": "string",
- "msisdn": "string"
}
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "identity": {
- "personalNumber": "string"
}, - "name": "string",
- "role": "NOBODY",
- "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
- "customerIds": [
- "497f6eca-6276-4993-bfeb-53cbbbba6f08"
], - "email": "user@example.com",
- "msisdn": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
Get the currently logged in user
Authorization required | string Bearer token |
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "identity": {
- "personalNumber": "string"
}, - "name": "string",
- "role": "NOBODY",
- "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
- "customerIds": [
- "497f6eca-6276-4993-bfeb-53cbbbba6f08"
], - "email": "user@example.com",
- "msisdn": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
id required | string <uuid> ID of user |
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "identity": {
- "personalNumber": "string"
}, - "name": "string",
- "role": "NOBODY",
- "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
- "customerIds": [
- "497f6eca-6276-4993-bfeb-53cbbbba6f08"
], - "email": "user@example.com",
- "msisdn": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
id required | string <uuid> ID of user |
name | string The name of the user |
customerId | string <uuid> The ID of the customer |
role | string Enum: "NOBODY" "MANAGER" "ADMIN" Role of the user. |
string The email of the user. A valid email address should be in the format example@domain.com | |
msisdn | string The phone number of the user. It must be in international format, starting with a '+' followed by the country code and the subscriber number, e.g. +123 4567890 |
{- "name": "string",
- "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
- "role": "NOBODY",
- "email": "string",
- "msisdn": "string"
}
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "identity": {
- "personalNumber": "string"
}, - "name": "string",
- "role": "NOBODY",
- "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
- "customerIds": [
- "497f6eca-6276-4993-bfeb-53cbbbba6f08"
], - "email": "user@example.com",
- "msisdn": "string",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z"
}
id required | string <uuid> ID of user |
customerId | string <uuid> The ID of the customer |
{- "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac"
}
{- "success": true,
- "message": "string"
}