Table of Contents

API : Special destination Create

Introduction

This request will create a new special destination: a Danish service number with its own connection fee and pr. minute rate.

Request

URL https://api.telecomx.dk/destination/special
Method POST
Access level RESELLER_ADMIN with FINANCE feature, or ADMIN.
Body _id String Prefix of the Danish special number: +45 followed by digits, e.g. +4590123456.
name String Name of the service offered.
fee Number Connection fee, 0-100000.
rate Number Pr. minute rate, 0-100000.
vatExemption Boolean [optional] True if the call is VAT free, default false.

Request body example

{
  "_id": "+4590123456",
  "name": "Example fundraising show",
  "fee": 1.5,
  "rate": 0.5,
  "vatExemption": true
}

Response

The created special destination is returned.

JSON object
_id String Prefix of the Danish special number.
name String Name of the service offered.
fee Number Connection fee.
rate Number Pr. minute rate.
vatExemption Boolean True if the call is VAT free.

Example

{
  "_id": "+4590123456",
  "name": "Example fundraising show",
  "fee": 1.5,
  "rate": 0.5,
  "vatExemption": true
}

Errors

Error code Message Description
404 _id Prefix is missing
404 name Name is missing
404 fee Fee is missing
404 rate Rate is missing
422 _id Prefix is not valid
422 name Name is not valid
422 fee Fee is not valid
422 rate Rate is not valid
409 _id The prefix already exists
403 access_denied Insufficient access level
500 internal_error <Unspecified>