Table of Contents

API : Internet Account Delete

Introduction

This request will cancel an Internet account. The account will terminate when the termination date has been reached.

Non-admin users may request termination on a given date. The actual date will be set by an admin when the cancellation has been ordered.

Request

URL https://api.telecomx.dk/internet/account/ACCOUNT_ID
Method DELETE
Access level MANAGER, 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 of the Internet account to delete.
Query terminationDate Date (ISO, e.g. 2026-09-01). Required unless force or cancel is true. Non-admin users: the date the customer wants termination (stored as requestedTerminationDate). RESELLER_ADMIN/ADMIN: the firm termination date.
force [optional] Boolean. If true, the account is deleted immediately. Should only be used to fix problems. (RESELLER_ADMIN / ADMIN only - ignored for other users).
cancel [optional] Boolean. If true, the pending termination is cancelled (RESELLER_ADMIN / ADMIN only - ignored for other users).

Query examples

https://api.telecomx.dk/internet/account/12345678901234567890AAAA?terminationDate=2026-09-01
https://api.telecomx.dk/internet/account/12345678901234567890AAAA?force=true
https://api.telecomx.dk/internet/account/12345678901234567890AAAA?cancel=true

Response

JSON object
success Boolean True on success

Example

{
  "success": true
}

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 changeRequest Cannot terminate while there is a pending change request
409 terminationDate Termination date does not honor commitment
422 circuit Circuit number is required
422 startDate Start date is required
422 multiple Multiple errors - see inner
403 access_denied Insufficient access level
500 internal_error <Unspecified>