api:internet:account:change-request
Table of Contents
API : Internet Account Request Change
Introduction
This will request a change of product (speed) on a DSL Internet account.
Request
| URL | https://api.telecomx.dk/internet/account/ACCOUNT_ID/change/request | ||
|---|---|---|---|
| Method | POST | ||
| Access level | OWNER if user belongs to the customer. RESELLER if customer belongs to the reseller or a sub reseller. RESELLER_ADMIN ADMIN. |
||
| Params | ACCOUNT_ID | Id | Id of the Internet Access account. |
| Body | newProduct | Id | New product the customer/reseller wishes to change to. |
| installCallNumber | String | [optional] Number that technician will call 30 minutes before arriving to install the service. Always overwrites the stored value; when omitted the stored value is cleared. |
|
| installCallName | String | [optional] Name of person technician will call 30 minutes before arriving to install the service. Always overwrites the stored value; when omitted the stored value is cleared. |
|
Query examples
{ "newProduct": "650000000000000000000008", "installCallNumber": "+4571919998", "installCallName": "Hans Eksempel" }
Response
The created change request.
| Property | Type | Description |
|---|---|---|
| state | String | State of change request: NONE, REQUESTED, ORDERED. |
| product | Id | New product customer wishes to change to. |
| by | Id | Id of employee who requested the change and who will get an e-mail when an offer is available. |
| date | Date | If state is REQUESTED - the date of the request. If state is ORDERED - the date the change will happen. |
| feeProduct | Id | Id of product for fee for change. null or omitted until confirmed. |
| monthlyCustomer | Number | Monthly fee customer - null or omitted, not used for DSL. |
Example
{ "state": "REQUESTED", "product": "650000000000000000000008", "by": "650000000000000000000004", "date": "2026-08-06T10:00:00.000Z", "feeProduct": null, "monthlyCustomer": null }
Errors
| Error code | Message | Description |
|---|---|---|
| 422 | <property> | Invalid input for the named property - the request body, query or URL parameter failed validation |
| 404 | _id | Internet account not found |
| 409 | type | Changes only possible for DSL type |
| 422 | changeRequest.product | Product not found or invalid for customer |
| 422 | multiple | Multiple errors - see inner |
| 403 | access_denied | Insufficient access level |
| 500 | internal_error | <Unspecified> |
api/internet/account/change-request.txt · Last modified: by Mikkel Meerwaldt Jørgensen