API : Roaming : Region List

Introduction

This request will return the list of regions.

Request

URL	https://api.telecomx.dk/roaming/region
Method	GET
Access level	VIEWER MANAGER OWNER RESELLER RESELLER_ADMIN ADMIN
Query	filter	`[optional]` Filters regions
Query	network	`[optional]` Filters on network. Allowed values are TDC, TELENOR.

Query examples

https://api.telecomx.dk/roaming/region
https://api.telecomx.dk/roaming/region?filter=Europa
https://api.telecomx.dk/roaming/region?filter=Europa&network=TDC

Response

JSON object
offset	Index of the first country returned.
limit	Number of regions to return. Note that the actual number of regions returned may be lower.
total	Number of regions that can be returned when offset and limit is not considered. This is to be used for paging through the data.
regions	Array of regions, see definition below

Field	Type	Description
_id	ObjectID	Id
names	Array	List of names, used for localization
names[].language	String	ISO 639-2 language code (three letter)
names[].text	String	The localization of the region name
network	String	Which network this region belongs to. Allowed values are TELENOR, TDC.
roamLikeHome	Boolean	Whether this region allows roam like home - for now, only used for EU countries.
homeland	Boolean	Whether this region is a “homeland” region. For now it's only used for Denmark.
notes	String	Notes if necessary (RESELLER_ADMIN and ADMIN only)
sms	Object	SMS properties (RESELLER_ADMIN and ADMIN only)
sms.cost	Number	Cost price for SMS's in this region
sms.wholesale	Number	Wholesale price for SMS's in this region
sms.price	Number	Customer price for SMS's in this region
data	Object	Data properties (RESELLER_ADMIN and ADMIN only)
data.cost	Number	Cost price per megabyte data usage in this region
data.wholesale	Number	Wholesale price per megabyte data usage in this region
data.price	Number	Customer price per megabyte data usage in this region
voice	Object	Voice properties (RESELLER_ADMIN and ADMIN only)
voice.inbound	Object	Inbound voice properties
voice.inbound.connectionFeeCost	Number	Cost price for receiving a call from this region
voice.inbound.connectionFeeWholesale	Number	Wholesale price for receiving a call from this region
voice.inbound.connectionFee	Number	Customer price for receiving a call from this region
voice.inbound.rateCost	Number	Cost price for per minute, when receiving a call from this region
voice.inbound.rateWholesale	Number	Wholesale price for per minute, when receiving a call from this region
voice.inbound.rate	Number	Customer price for per minute, when receiving a call from this region
voice.outbound	Array	List of regions, with the prices for calling them.
voice.outbound[]._id	ObjectId	ID of region
voice.outbound[].connectionFeeCost	Number	Cost price for starting a call to this region
voice.outbound[].connectionFeeWholesale	Number	Wholesale price for starting a call to this region
voice.outbound[].connectionFee	Number	Customer price for starting a call to this region
voice.outbound[].rateCost	Number	Cost price for per minute, when calling this region
voice.outbound[].rateWholesale	Number	Wholesale price for per minute, when calling this region
voice.outbound[].rate	Number	Customer price for per minute, when receiving a call from this region

Example

{
  _id: ObjectID('1234567890ABCDEF12345678'),
  names: [
    {
      language: 'dan',
      text: 'EU & Vest-Europa'
    },
    {
      language: 'eng',
      text: 'EU & Western Europe'
    }
  ],
  network: 'TELENOR',
  roamLikeHome: true,
  homeland: false,
  notes: 'This region is for all EU and EEA countries, including Switzerland, Norway, Iceland, and Lichenstein' 
  sms: {
    cost: 0.05,
    wholesale: 0.06,
    price: 0.07
  },
  data: {
    cost: 0.078,
    wholesale: 0.082,
    price: 0.09
  },
  voice: {
    inbound: {
      connectionFeeCost: 0.1,
      connectionFeeWholesale: 0.2,
      connectionFee: 0.025,
      rateCost: 0.1,
      rateWholesale: 0.15,
      rate: 0.18
    },
    outbound: [
      {
        _id: ObjectID('2234567890ABCD123456789'),
        connectionFeeCost: 0.15,
        connectionFeeWholesale: 0.19,
        connectionFee: 0.21
        rateCost: 0.1,
        rateWholesale: 0.15,
        rate: 0.18
      },
      {
        _id: ObjectID('3234567890ABCD123456789'),
        connectionFeeCost: 0.21,
        connectionFeeWholesale: 0.22,
        connectionFee: 0.24
        rateCost: 0.17,
        rateWholesale: 0.20,
        rate: 0.26
      },
      {
        ...
      }
    ]
  }
 
}

Errors

Error code	Message	Description
403	access_denied	Insufficient access level
500	internal_error	<Unspecified>

WIKI

Table of Contents

API : Roaming : Region List

Introduction

Request

Query examples

Response

Example

Errors