1. REST API Reference for Billing Care
  2. Tasks
  3. Subscriptions

Get Packages for Transition

get

/bcws/webresources/v1.0/subscriptions/packages/{id}/transition

Gets the list of packages that the specified package can transition to with the specified transition type.

Both the id parameter and the type query parameter are required.

Request

Path Parameters
Query Parameters
  • The transition type, which can be:
    • 1 (Upgrade)
    • 2 (Downgrade)
    • 3 (Generation change)
    • 101Red
    • 102 (Blue)
    • 103 (Green)

    This query parameter is required.

There's no request body for this operation.

Back to Top

Response

Supported Media Types

200 Response

The list of packages was returned successfully.
Body ()
Root Schema : packageList
Type: object
Show Source
Nested Schema : extension
Type: object
The extended attributes.
Nested Schema : package
Type: array
Show Source
Nested Schema : package
Type: object
Show Source
Nested Schema : balanceGroups
Type: array
Balance groups associated with the package.
Show Source
Nested Schema : serviceGroup
Type: array
Show Source
Nested Schema : serviceIds
Type: array
The list of service IDs associated with the package.
Show Source
Nested Schema : SubscriptionTerms
Type: object
Show Source
Nested Schema : BalanceGroups
Type: object
Balance groups associated with the package.
Show Source
Nested Schema : limits
Type: array
Show Source
Nested Schema : rules
Type: array
The list of consumption rules that define the order in which to consume balances.
Show Source
Nested Schema : LimitType
Type: object
Show Source
  • The consumption rule. Can be one of the following:
    • 0: Not defined
    • 1: Earliest start time
    • 2: Latest start time
    • 3: Earliest expiration time
    • 4: Latest expiration time
    • 5: Earliest start time and latest expiration time
    • 6: Earliest start time and earliest expiration time
    • 7: Latest start time and earliest expiration time
    • 8: Latest start time and latest expiration time
    • 9: Earliest expiration time and earliest start time
    • 10: Earliest expiration time and latest start time
    • 10: Latest expiration time and earliest start time
    • 10: Latest expiration time and latest start time
  • The credit floor amount. The credit floor is the amount that indicates none of the balance has been used. For example, if an account is granted 200 minutes, the credit floor would be -200. For currency balances, the credit floor is usually 0.
  • The credit limit amount. A credit limit specifies the maximum amount of a balance that your customers can spend. For currency balances, the credit limit is the maximum balance of euros, dollars, or so on that can accumulate in an account. For noncurrency balances, the credit limit is the amount at which an account has used all of its minutes, gigabytes, or so on, which is usually 0.
  • The percent threshold for notifications. The account is sent a notification when this percent of the balance is used. The percentage must be a 5% increment. Use the decimal notation of the binary number for the bit position.

    For example, to notify the account when 90% of the free minutes have been used, you calculate 90/5=18, so use the 18th bit position, which is 131072 in decimal notation. To notify when 95% have been used, use the 19th bit position, which is 262144 in decimal notation.

  • The fixed threshold for notifications. The account is sent a notification when this fixed value of the balance is reached. You can set multiple values by using the | delimiter. For example, to notify the account when 30 minutes of usage remains and again when 5 minutes of usage remains, use |30.00|5.00
  • Whether to use a dynamic credit floor (true) or not (false). The default is false.
  • The resource ID.
Nested Schema : Rules
Type: object
The list of consumption rules that define the order in which to consume balances.
Show Source
  • The consumption rule. Can be one of the following:
    • 0: Not defined
    • 1: Earliest start time
    • 2: Latest start time
    • 3: Earliest expiration time
    • 4: Latest expiration time
    • 5: Earliest start time and latest expiration time
    • 6: Earliest start time and earliest expiration time
    • 7: Latest start time and earliest expiration time
    • 8: Latest start time and latest expiration time
    • 9: Earliest expiration time and earliest start time
    • 10: Earliest expiration time and latest start time
    • 10: Latest expiration time and earliest start time
    • 10: Latest expiration time and latest start time
  • The position of the entry in the array. For example, the first item in a list would have an elem value of 1.
Nested Schema : GroupOfServices
Type: object
Show Source
Nested Schema : service
Type: array
Show Source
Nested Schema : ServiceInPlan
Type: object
Show Source
Nested Schema : bundles
Type: array
The list of bundles in the service.
Show Source
Nested Schema : Bundles
Type: object
The list of bundles in the service.
Show Source
Nested Schema : chargeoffers
Type: array
The list of charge offers in the bundle.
Show Source
Nested Schema : discountoffers
Type: array
The list of discount offers in the bundle.
Show Source
Nested Schema : ResourceRef
Type: object
Show Source
Nested Schema : Chargeoffers
Type: object
The list of charge offers in the bundle.
Show Source
Nested Schema : Discountoffers
Type: object
The list of discount offers in the bundle.
Show Source
Nested Schema : extension
Type: object
The extended attributes.

500 Response

EAn internal server error occurred.
Back to Top

Examples

This example shows how to get the packages that a specified package can transition to with the specified transition type by submitting a GET request on the REST resource using cURL. For more information about cURL, see "Use cURL".

cURL Command

curl -X GET 'http://hostname:port/bcws/webresources/version/subscriptions/packages/0.0.0.1+-plan+8862197/transition?type=1'

where:

  • hostname is the URL for the Billing Care REST server.
  • port is the port for the Billing Care REST server.
  • version is the version of the API you're using, such as v1.0.

Example of Response Body

This example shows the contents of the response body in JSON format.

{
    "extension":null,
    "package":[
        {
            "id":"0.0.0.1+-plan+8861173",
            "creationDate":null,
            "description":"",
            "lastModified":null,
            "validTo":null,
            "name":"Package_Transition2",
            "tags":"Uncategorized",
            "serviceGroup":[
                {
                    "service":[
                        {
                            "serviceKey":"/service/broadband28710096",
                            "serviceType":"/service/broadband",
                            "balGrpIndex":0,
                            "groupParent":false,
                            "subscriptionIndex":0,
                            "bundles":[
                                {
                                    "ref":{
                                        "id":"0.0.0.1+-deal+8862453",
                                        "uri":null
                                    },
                                    "required":true,
                                    "name":"Deal_Plan_Transition_Broadband2",
                                    "description":"",
                                    "chargeoffers":[
                                        {
                                            "name":"Product_BroadBand2",
                                            "description":"",
                                            "ref":{
                                                "id":"0.0.0.1+-product+8863605",
                                                "uri":null
                                            }
                                        }
                                    ],
                                    "discountoffers":[],
                                    "elem":null
                                }
                            ]
                        }
                    ],
                    "groupIndex":0
                }
            ],
            "packageId":null,
            "serviceIds":[],
            "purchaseFeeWaived":null,
            "terminationFeeWaived":null,
            "balanceGroups":[],
            "subscriptionTerms":null
        }
    ]
}
Back to Top