Get plan definitions for a booster

This GET operation retrieves a list of plan definitions that are associated with the specified booster. You can also omit the booster id and use query parameters to see what plan definitions have a booster associated with them. If successful, you receive an HTTP response code of 200 as well as a JSON response which includes the plan definitions by name in an array.

See HTTP response codes for other response codes.

GET /pcc/spcm/boosters/<id>/planDefinitions OR

/pcc/spcm/boosters/planDefinitions + query parameters

HEADER INFO

authorisation: HTTP Basic Auth

tenant: <tenantName>

content-type: application/JSON

accept: application/JSON

By default, accept is XML. You must explicitly set accept in your header to application/JSON to receive a JSON response.

permissions: SPCM_PLAN_BOOSTER_READ_PERMISSION

URL parameters

Parameter Type Description

id

integer

The unique identifier of the booster.

Query parameters

example
/pcc/spcm/boosters/planDefinitions?name=planDefA&name=planDefB
Parameter Type Description

name

string

The name of the plan definition.


JSON response

The following sample shows the expected result when using the query parameters to see what plan definitions have boosters; in this case, both planDefinitionA and planDefinitionB have boosters associated with them. See Plan definition descriptions for all possible data types.

You only receive a JSON response if you use the query parameters. 
{
    [
        "planDefinitionA",
        "planDefinitionB"
    ]
}

Booster type descriptions

Field Type Description

id

integer

The unique identifier for the booster. This is assigned by the server upon creating a booster.

type

string

The type of booster desired by the user.

options

  • VOLUME which boosts data

  • VALIDITY which extends the plan

amount

string

The amount of data (or extension of plan).

VOLUME is in bytes, so you boost by the bytes you would like to increase. VALIDITY is in days, so you need to specify the number of days you wish to extend the plan by.

cost

integer

Specifies the cost of the booster.


HTTP response codes

Code Description

200

success!

207

Multistatus response

Check out HTTP statuses for more details.
This is not applicable to all operations.

400

malformed request

401

unauthorised; bad username or password

403

forbidden; user does not have appropriate privileges

404

booster not found

409

conflict with target resource

This often occurs if the item already exists, such as a plan, group, or name.
This is not applicable to all operations.

412

failed validation; this typically means that a property was not set or a value is out of range.

example
HTTP 412
{
  "errors" : [
        {
          "field" : "name",
          "description" : "name is mandatory"
        }
    ]
}

422

failed processing (after passing validation).

example
HTTP 422
{
    "message": "Subscriber max plan count exceeded",
    "errorCode": 1
}

500

internal error

503

request rejected due to overload