Superloop Connect - Service Plan Change

Introduction

Use these endpoints to perform a service plan change.

Request Specifications

Table 1. API Versions
Version	Header	Changes
1 (Deprecated)	X-API-VERSION=1	Initial Version
2 (Deprecated)	X-API-VERSION=2	No change
3	X-API-VERSION=3	No change
4	X-API-VERSION=4	No change
5	X-API-VERSION=5	No change
6	X-API-VERSION=6	Optional field `restorationSla` added to the POST
7	X-API-VERSION=7	No change

API Version 6 and 7

Request Lifecycle

Changing a service’s plan and/or restoration SLA is a two step process. It allows you to do:

Plan Change

You need to pass in new Plan (price may change based on new Plan and pricing changes of current SLA)

SLA Change

You need to pass in existing Plan, new SLA (price may change based on pricing changes of current Plan and new SLA)

Plan Change plus SLA change

You need to pass in new Plan, new SLA (price may change based on new Plan and new SLA)

Create a service-plan-change-request resource, by sending a POST request to /api/connect/services/plan-changes/request with the body of the request containing the service id, the plan name , term and restorationSla (optional). The response’s http status will be 201 with a blank response body. There will be a Location response header with a URL. This URL is where the request outcome can be obtained.
Make a GET request to the URL returned in 1. to retrieve the outcome of the request. While the request is in progress, the response’s http status will be 202. This means that the request has not finished yet, but will in a moment. If the request was successful a service-plan-change resource will be returned. If the request failed a 422 will be returned with the body containing details on why it failed in the standard error format.

POST Request

Table 2. POST Request
Verb	POST
URI	/api/connect/services/plan-changes/request

Table 3. POST HTTP Request Headers
Name	Description
`Authorization`	The OAuth bearer access token
`X-API-VERSION`	The version of the endpoint you are accessing

Table 4. POST Request Body Fields
Path	Type	Description	Required
`serviceId`	`Number`	The id of the service.	Required
`planName`	`String`	The plan name.	Required
`term`	`Number`	The plan term.	Required
`restorationSla`	`String`	The service restoration SLA

POST Response

Table 5. POST HTTP Status Codes
Status Code	Meaning
201	The request was created successfully
401	Bearer token is missing or invalid
404	You do not have permission to perform this task
422	There are validation errors on the request you made. Check the response body to see what fields had issues.
500	There was an unexpected error processing the request
502	There was an unexpected error with one or more of the upstream services

Table 6. POST HTTP Response Headers
Name	Description
`Location`	The URL of the service-plan-change-request resource

GET Request

Note	The URI will be given to you in the Location header of the POST request of the Service Plan Change request.

Table 7. GET Request
Verb	GET
URI	/api/connect/services/plan-changes/requests/{id}

Table 8. GET Request Path Variables
Path Variable	Purpose
`id`	The id of the service-plan-change-request resource to poll for completion status

Table 9. GET HTTP Request Headers
Name	Description
`Authorization`	The OAuth bearer access token
`X-API-VERSION`	The version of the endpoint you are accessing

GET Response

Table 10. GET HTTP Status Codes
Status Code	Meaning
200	The request is complete. The body contains the service-plan-change resource
202	The request is in progress
401	Bearer token is missing or invalid
404	You are not authorised or The id (of the service-plan-change-request resource) provided does not exist
422	The service-plan-change resource failed to be created. Check the response body to see why
500	There was an unexpected error processing the request
502	There was an unexpected error with one or more of the upstream services

Table 11. GET Response Body Fields
Path	Type	Description
`id`	`Number`	The Connect identifier of the plan change request resource.
`serviceId`	`Number`	The Connect identifier of the service resource.
`sla`	`Object`	Service Restoration SLA fee applied for the service plan change.
`sla.sla`	`String`	Name of the SLA.
`sla.fee`	`Object`	Applied charge for the addon type.
`sla.fee.attributes`	`Object`	Attributes of the addon type. Typically includes the sla name
`sla.fee.oneTimeCharge.amount`	`String`	One time charge of the addon type.
`sla.fee.oneTimeCharge.currency`	`String`	Currency of the addon type charge.
`sla.fee.oneTimeCharge.symbol`	`String`	Symbol of the addon type charge currency.
`sla.fee.monthlyRecurringCharge.amount`	`String`	Monthly recurring charge of the addon type.
`sla.fee.monthlyRecurringCharge.currency`	`String`	Currency of the monthly recurring charge.
`sla.fee.monthlyRecurringCharge.symbol`	`String`	Symbol of the monthly recurring charge currency.
`plan`	`Object`	Information of the service plan change.
`plan.plan`	`String`	Name of the plan.
`plan.term`	`String`	Term of the plan.
`plan.planFee`	`Object`	Applied fee for the service plan change.
`plan.planFee.attributes`	`Object`	Attributes of the changed plan. Typically includes a plan and a term
`plan.planFee.oneTimeCharge.amount`	`String`	One time charge for the changed plan.
`plan.planFee.oneTimeCharge.currency`	`String`	Currency of the one time charge.
`plan.planFee.oneTimeCharge.symbol`	`String`	Symbol of the one time charge currency.
`plan.planFee.monthlyRecurringCharge.amount`	`String`	Monthly recurring charge of the ordered plan.
`plan.planFee.monthlyRecurringCharge.currency`	`String`	Currency of the monthly recurring charge.
`plan.planFee.monthlyRecurringCharge.symbol`	`String`	Symbol of the monthly recurring charge currency.
`plan.nfasFee`	`Object`	NFAS Commitment fee for the service plan change if applied else null
`requestedOn`	`String`	The date/time, including UTC offset, when service plan change requested

Webhook - ServicePlanChanged

The ServicePlanChanged notification is sent when a service plan change you have requested has been accepted by the nbn, to find more information click here

Currently sent ServiceModified notification for a successful plan change request is deprecated and will be removed shortly. Please move to dedicated ServicePlanChanged webhook event.

Webhook - ServicePlanChangeRejected

The ServicePlanChangeRejected notification is sent when a service plan change you have requested has been rejected by the nbn, to find more information click here

Currently sent ServiceModificationRejected notification for a failed plan change request is deprecated and will be removed shortly. Please move to dedicated ServicePlanChangeRejected webhook event.

Webhook - ServiceRestorationSlaChanged

The ServiceRestorationSlaChanged notification is sent when a service restoration sla change you have requested has been accepted by the nbn, to find more information click here

API Version 6 and 7 - Examples

Successful Request

Plan Change only

A service-plan-change-request resource is created by sending a POST request to /api/connect/services/plan-changes/request.

POST Request

POST /api/connect/services/plan-changes/request HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer **token**
X-API-VERSION: 7
Content-Length: 100
Host: 360-api.superloop.com

{
  "serviceId" : 1600,
  "planName" : "Home Fast 100/40",
  "term" : 1,
  "restorationSla" : null
}

If all required fields were given, then the response to the request will have:

a http status of 201
a Location header with the URI of the service-plan-change-request resource.

Successful POST Response

HTTP/1.1 201 Created
Location: /api/connect/services/plan-changes/requests/11
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY

Once you have the URI from the Location header, poll that URI every so often by making a GET request. While the plan change is in progress, the GET request’s response will have a http status of 202. Keep polling the URL until it finishes, once the request is completed successfully the GET request’s response will have a http status of 200.

Note	Please keep the polling to a sensible rate.

GET Request

GET /api/connect/services/plan-changes/requests/2 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer **token**
X-API-VERSION: 7
Host: 360-api.superloop.com

Successful GET Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 888

{
  "id" : 2,
  "serviceId" : 1500,
  "plan" : {
    "plan" : "Home Fast 100/40",
    "term" : "1",
    "planFee" : {
      "attributes" : {
        "plan" : "Home Fast 100/40",
        "term" : "1"
      },
      "oneTimeCharge" : {
        "amount" : "0.00",
        "currency" : "AUD",
        "symbol" : "&#36;"
      },
      "monthlyRecurringCharge" : {
        "amount" : "73.00",
        "currency" : "AUD",
        "symbol" : "&#36;"
      }
    },
    "nfasFee" : null
  },
  "sla" : {
    "sla" : "Standard",
    "fee" : {
      "attributes" : {
        "sla" : "Standard"
      },
      "oneTimeCharge" : {
        "amount" : "0.00",
        "currency" : "AUD",
        "symbol" : "&#36;"
      },
      "monthlyRecurringCharge" : {
        "amount" : "0.00",
        "currency" : "AUD",
        "symbol" : "&#36;"
      }
    }
  },
  "requestedOn" : "2020-07-01T04:32:58Z"
}

SLA Change Only

POST Request

POST /api/connect/services/plan-changes/request HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer **token**
X-API-VERSION: 7
Content-Length: 111
Host: 360-api.superloop.com

{
  "serviceId" : 1600,
  "planName" : "Home Fast 100/20",
  "term" : 1,
  "restorationSla" : "Enhanced - 12"
}

GET Request

GET /api/connect/services/plan-changes/requests/8 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer **token**
X-API-VERSION: 7
Host: 360-api.superloop.com

Successful GET Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 897

{
  "id" : 8,
  "serviceId" : 2300,
  "plan" : {
    "plan" : "Home Fast 100/20",
    "term" : "1",
    "planFee" : {
      "attributes" : {
        "plan" : "Home Fast 100/20",
        "term" : "1"
      },
      "oneTimeCharge" : {
        "amount" : "0.00",
        "currency" : "AUD",
        "symbol" : "&#36;"
      },
      "monthlyRecurringCharge" : {
        "amount" : "65.00",
        "currency" : "AUD",
        "symbol" : "&#36;"
      }
    },
    "nfasFee" : null
  },
  "sla" : {
    "sla" : "Enhanced - 8",
    "fee" : {
      "attributes" : {
        "sla" : "Enhanced - 8"
      },
      "oneTimeCharge" : {
        "amount" : "0.00",
        "currency" : "AUD",
        "symbol" : "&#36;"
      },
      "monthlyRecurringCharge" : {
        "amount" : "28.00",
        "currency" : "AUD",
        "symbol" : "&#36;"
      }
    }
  },
  "requestedOn" : "2020-07-01T04:32:58Z"
}

Plan Plus SLA Change

POST Request

POST /api/connect/services/plan-changes/request HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer **token**
X-API-VERSION: 7
Content-Length: 111
Host: 360-api.superloop.com

{
  "serviceId" : 1600,
  "planName" : "Home Fast 100/40",
  "term" : 1,
  "restorationSla" : "Enhanced - 12"
}

GET Request

GET /api/connect/services/plan-changes/requests/9 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer **token**
X-API-VERSION: 7
Host: 360-api.superloop.com

Successful GET Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 897

{
  "id" : 9,
  "serviceId" : 2400,
  "plan" : {
    "plan" : "Home Fast 100/40",
    "term" : "1",
    "planFee" : {
      "attributes" : {
        "plan" : "Home Fast 100/40",
        "term" : "1"
      },
      "oneTimeCharge" : {
        "amount" : "0.00",
        "currency" : "AUD",
        "symbol" : "&#36;"
      },
      "monthlyRecurringCharge" : {
        "amount" : "73.00",
        "currency" : "AUD",
        "symbol" : "&#36;"
      }
    },
    "nfasFee" : null
  },
  "sla" : {
    "sla" : "Enhanced - 8",
    "fee" : {
      "attributes" : {
        "sla" : "Enhanced - 8"
      },
      "oneTimeCharge" : {
        "amount" : "0.00",
        "currency" : "AUD",
        "symbol" : "&#36;"
      },
      "monthlyRecurringCharge" : {
        "amount" : "28.00",
        "currency" : "AUD",
        "symbol" : "&#36;"
      }
    }
  },
  "requestedOn" : "2020-07-01T04:32:58Z"
}

Plan Change NFAS Commitment Fee Applied

GET Request

GET /api/connect/services/plan-changes/requests/10 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer **token**
X-API-VERSION: 7
Host: 360-api.superloop.com

Successful GET Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 1204

{
  "id" : 10,
  "serviceId" : 1200,
  "plan" : {
    "plan" : "Home Fast 100/40",
    "term" : "1",
    "planFee" : {
      "attributes" : {
        "plan" : "Home Fast 100/40",
        "term" : "1"
      },
      "oneTimeCharge" : {
        "amount" : "0.00",
        "currency" : "AUD",
        "symbol" : "&#36;"
      },
      "monthlyRecurringCharge" : {
        "amount" : "73.00",
        "currency" : "AUD",
        "symbol" : "&#36;"
      }
    },
    "nfasFee" : {
      "attributes" : {
        "nfas_commitment_fee" : true
      },
      "oneTimeCharge" : {
        "amount" : "25.00",
        "currency" : "AUD",
        "symbol" : "&#36;"
      },
      "monthlyRecurringCharge" : {
        "amount" : "0.00",
        "currency" : "AUD",
        "symbol" : "&#36;"
      }
    }
  },
  "sla" : {
    "sla" : "Standard",
    "fee" : {
      "attributes" : {
        "sla" : "Standard"
      },
      "oneTimeCharge" : {
        "amount" : "0.00",
        "currency" : "AUD",
        "symbol" : "&#36;"
      },
      "monthlyRecurringCharge" : {
        "amount" : "0.00",
        "currency" : "AUD",
        "symbol" : "&#36;"
      }
    }
  },
  "requestedOn" : "2020-07-01T04:32:58Z"
}

Invalid Request

If the request is invalid for any reason, a http status of 422 is returned and the body of the response will list the problems with the request.

This example is of submitting a service plan change request with an invalid planName field.

POST Request- Service Plan Change

POST /api/connect/services/plan-changes/request HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer **token**
X-API-VERSION: 7
Content-Length: 93
Host: 360-api.superloop.com

{
  "serviceId" : 1500,
  "planName" : "Plan-Name",
  "term" : 1,
  "restorationSla" : null
}

POST Response with request validation errors

HTTP/1.1 422 Unprocessable Entity
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 396

{
  "httpStatusCode" : 422,
  "type" : "client.validation",
  "code" : "validation",
  "message" : "Validation error",
  "apiSubErrors" : [ {
    "code" : "constraints.plan.change.plan.name.invalid",
    "message" : "The Plan is unavailable",
    "object" : "ServicePlanChange",
    "field" : "planName",
    "rejectedValue" : "Plan-Name"
  } ],
  "timestamp" : "2025-03-11T22:28:33.587069935Z"
}

Resource failed to be created

If the service-plan-change resource failed to be created, a http status of 422 is returned and the body of the response will list the reason why

GET Request

GET /api/connect/services/plan-changes/requests/3 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer **token**
X-API-VERSION: 7
Host: 360-api.superloop.com

GET Response service-plan-change resource failed to be created

HTTP/1.1 422 Unprocessable Entity
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 403

{
  "httpStatusCode" : 422,
  "type" : "client.validation",
  "code" : "validation",
  "message" : "Validation error",
  "apiSubErrors" : [ {
    "code" : "constraints.service.plan.change.status.in.error",
    "message" : "Plan is no longer available",
    "object" : "ServicePlanChange",
    "field" : "status",
    "rejectedValue" : "IN_ERROR"
  } ],
  "timestamp" : "2025-03-11T22:28:39.938718837Z"
}

API Version 1, 2, 3, 4 and 5

Request Lifecycle

Changing a service’s plan is a two step process as follows:

Create a service-plan-change-request resource, by sending a POST request to /api/connect/services/plan-changes/request with the body of the request containing the service id, the plan name and term. The response’s http status will be 201 with a blank response body. There will be a Location response header with a URL. This URL is where the request outcome can be obtained.
Make a GET request to the URL returned in 1. to retrieve the outcome of the request. While the request is in progress, the response’s http status will be 202. This means that the request has not finished yet, but will in a moment. If the request was successful a service-plan-change resource will be returned. If the request failed a 422 will be returned with the body containing details on why it failed in the standard error format.

POST Request

Table 12. POST Request
Verb	POST
URI	/api/connect/services/plan-changes/request

Table 13. POST HTTP Request Headers
Name	Description
`Authorization`	The OAuth bearer access token
`X-API-VERSION`	The version of the endpoint you are accessing

Table 14. POST Request Body Fields
Path	Type	Description	Required
`serviceId`	`Number`	The id of the service.	Required
`planName`	`String`	The plan name.	Required
`term`	`Number`	The plan term.	Required

POST Response

Table 15. POST HTTP Status Codes
Status Code	Meaning
201	The request was created successfully
401	Bearer token is missing or invalid
404	You do not have permission to perform this task
422	There are validation errors on the request you made. Check the response body to see what fields had issues.
500	There was an unexpected error processing the request
502	There was an unexpected error with one or more of the upstream services

Table 16. POST HTTP Response Headers
Name	Description
`Location`	The URL of the service-plan-change-request resource

GET Request

Note	The URI will be given to you in the Location header of the POST request of the Service Plan Change request.

Table 17. GET Request
Verb	GET
URI	/api/connect/services/plan-changes/requests/{id}

Table 18. GET Request Path Variables
Path Variable	Purpose
`id`	The id of the service-plan-change-request resource to poll for completion status

Table 19. GET HTTP Request Headers
Name	Description
`Authorization`	The OAuth bearer access token
`X-API-VERSION`	The version of the endpoint you are accessing

GET Response

Table 20. GET HTTP Status Codes
Status Code	Meaning
200	The request is complete. The body contains the service-plan-change resource
202	The request is in progress
401	Bearer token is missing or invalid
404	You are not authorised or The id (of the service-plan-change-request resource) provided does not exist
422	The service-plan-change resource failed to be created. Check the response body to see why
500	There was an unexpected error processing the request
502	There was an unexpected error with one or more of the upstream services

Table 21. GET Response Body Fields
Path	Type	Description
`id`	`Number`	The Connect identifier of the plan change request resource.
`serviceId`	`Number`	The Connect identifier of the service resource.
`additionalFees`	`Array`	List of additional fees applied for the service plan change.
`additionalFees.[].addOnTypeName`	`String`	Name of the addon type.
`additionalFees.[].fee`	`Object`	Applied charge for the addon type.
`additionalFees.[].fee.attributes`	`Object`	Attributes of the addon type. Varies depending on the addon type. For instance, an SLA addon type would include the sla name
`additionalFees.[].fee.oneTimeCharge.amount`	`String`	One time charge of the addon type.
`additionalFees.[].fee.oneTimeCharge.currency`	`String`	Currency of the addon type charge.
`additionalFees.[].fee.oneTimeCharge.symbol`	`String`	Symbol of the addon type charge currency.
`additionalFees.[].fee.monthlyRecurringCharge.amount`	`String`	Monthly recurring charge of the addon type.
`additionalFees.[].fee.monthlyRecurringCharge.currency`	`String`	Currency of the monthly recurring charge.
`additionalFees.[].fee.monthlyRecurringCharge.symbol`	`String`	Symbol of the monthly recurring charge currency.
`fee`	`Object`	Applied fee for the service plan change.
`fee.attributes`	`Object`	Attributes of the changed plan. Typically includes a plan and a term
`fee.oneTimeCharge.amount`	`String`	One time charge for the changed plan.
`fee.oneTimeCharge.currency`	`String`	Currency of the one time charge.
`fee.oneTimeCharge.symbol`	`String`	Symbol of the one time charge currency.
`fee.monthlyRecurringCharge.amount`	`String`	Monthly recurring charge of the ordered plan.
`fee.monthlyRecurringCharge.currency`	`String`	Currency of the monthly recurring charge.
`fee.monthlyRecurringCharge.symbol`	`String`	Symbol of the monthly recurring charge currency.
`requestedOn`	`String`	The date/time, including UTC offset, when service plan change requested

Webhook - ServicePlanChanged

The ServicePlanChanged notification is sent when a service plan change you have requested has been accepted by the nbn, to find more information click here

Currently sent ServiceModified notification for a successful plan change request is deprecated and will be removed shortly. Please move to dedicated ServicePlanChanged webhook event.

Webhook - ServicePlanChangeRejected

The ServicePlanChangeRejected notification is sent when a service plan change you have requested has been rejected by the nbn, to find more information click here

Currently sent ServiceModificationRejected notification for a failed plan change request is deprecated and will be removed shortly. Please move to dedicated ServicePlanChangeRejected webhook event.

API Version 1, 2, 3, 4 and 5 - Examples

Successful Request

Plan Change only

A service-plan-change-request resource is created by sending a POST request to /api/connect/services/plan-changes/request.

POST Request

POST /api/connect/services/plan-changes/request HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer **token**
X-API-VERSION: 5
Content-Length: 73
Host: 360-api.superloop.com

{
  "serviceId" : 1600,
  "planName" : "Home Fast 100/40",
  "term" : 1
}

If all required fields were given, then the response to the request will have:

a http status of 201
a Location header with the URI of the service-plan-change-request resource.

Successful POST Response

HTTP/1.1 201 Created
Location: /api/connect/services/plan-changes/requests/11
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY

Note	Please keep the polling to a sensible rate.

GET Request

GET /api/connect/services/plan-changes/requests/2 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer **token**
X-API-VERSION: 5
Host: 360-api.superloop.com

Successful GET Response

HTTP/1.1 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 782

{
  "id" : 2,
  "serviceId" : 1500,
  "additionalFees" : [ {
    "addOnTypeName" : "SLA",
    "fee" : {
      "attributes" : {
        "sla" : "Standard"
      },
      "oneTimeCharge" : {
        "amount" : "0.00",
        "currency" : "AUD",
        "symbol" : "&#36;"
      },
      "monthlyRecurringCharge" : {
        "amount" : "0.00",
        "currency" : "AUD",
        "symbol" : "&#36;"
      }
    }
  } ],
  "fee" : {
    "attributes" : {
      "plan" : "Home Fast 100/40",
      "term" : "1"
    },
    "oneTimeCharge" : {
      "amount" : "0.00",
      "currency" : "AUD",
      "symbol" : "&#36;"
    },
    "monthlyRecurringCharge" : {
      "amount" : "73.00",
      "currency" : "AUD",
      "symbol" : "&#36;"
    }
  },
  "requestedOn" : "2020-07-01T04:32:58Z"
}

Invalid Request

If the request is invalid for any reason, a http status of 422 is returned and the body of the response will list the problems with the request.

This example is of submitting a service plan change request with an invalid planName field.

POST Request- Service Plan Change

POST /api/connect/services/plan-changes/request HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer **token**
X-API-VERSION: 5
Content-Length: 66
Host: 360-api.superloop.com

{
  "serviceId" : 1500,
  "planName" : "Plan-Name",
  "term" : 1
}

POST Response with request validation errors

HTTP/1.1 422 Unprocessable Entity
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 396

{
  "httpStatusCode" : 422,
  "type" : "client.validation",
  "code" : "validation",
  "message" : "Validation error",
  "apiSubErrors" : [ {
    "code" : "constraints.plan.change.plan.name.invalid",
    "message" : "The plan is unavailable",
    "object" : "ServicePlanChange",
    "field" : "planName",
    "rejectedValue" : "Plan-Name"
  } ],
  "timestamp" : "2025-03-11T22:28:19.746381805Z"
}

Resource failed to be created

If the service-plan-change resource failed to be created, a http status of 422 is returned and the body of the response will list the reason why

GET Request

GET /api/connect/services/plan-changes/requests/3 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer **token**
X-API-VERSION: 5
Host: 360-api.superloop.com

GET Response service-plan-change resource failed to be created

HTTP/1.1 422 Unprocessable Entity
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 403

{
  "httpStatusCode" : 422,
  "type" : "client.validation",
  "code" : "validation",
  "message" : "Validation error",
  "apiSubErrors" : [ {
    "code" : "constraints.service.plan.change.status.in.error",
    "message" : "Plan is no longer available",
    "object" : "ServicePlanChange",
    "field" : "status",
    "rejectedValue" : "IN_ERROR"
  } ],
  "timestamp" : "2025-03-11T22:28:20.900241719Z"
}