API : CustomerSubscriptions List

This request will return all the subscriptions for either a given a customer, or a reseller. The reseller subscriptions is a summary of all of their customers' subscriptions.

For customers, all subscriptions are grouped per product, so the overview will show Product X, its price and wholesale, and the subscriptions/accounts that use this product.

For resellers, the grouping works similarly, but it goes a level beyond that, and groups all products on their reseller product, then showing per-customer usage under each product.

Both views are sorted by kind - the entry's accountType when it has one, else the product's type - and then by name, in Danish alphabetical order.

https://api.telecomx.dk/customer/subscriptions?customer=1234567890ABCDEF12345678
https://api.telecomx.dk/customer/subscriptions?customer=1234567890ABCDEF12345678&format=csv
https://api.telecomx.dk/customer/subscriptions?reseller=8211399890BBBDEF12345178
https://api.telecomx.dk/customer/subscriptions?reseller=8211399890BBBDEF12345178&format=csv

The customer view and the reseller view return different objects, described below. A sum is null when a price or wholesale it adds up is missing, so below RESELLER every sumWholesale in the customer view is null.

Note that properties holding no value may be omitted from the object.

Each kind of subscription also holds its own properties:

• EMPLOYEE (PBX user): accessLevel, invoicedUntil, addonProducts (the user's add-ons, the same objects listed as add-on subscriptions) and subscriptions (always an empty array).
• Add-on of a PBX user (no type): employee (the PBX user), description, unitPrice, start, earliestStart, terminate, invoicedUntil, employeeId and employeeName. The name is the add-on's name and the user's name separated by : '', or the user's name alone. * ''PBX_EXTENSION: employee and invoicedUntil. Only extensions with a product of their own are listed.
• PBX_SIP_PHONE: sipPhoneModel, matchingSipPhoneModel (the model's _id, brand and model, or only the model id when the model no longer exists), extension, employee (the user of the extension) and invoicedUntil. A phone without a name is named <brand>: <model>.
• MVNO and SIP: ratePlan (the same as product), numbers and invoicedUntil. A mobile account also has employee (the user of its extension or number), sipAccount, extension, smartWatch (its smartwatch and the SIM's details, as stored) and dataSharingSims (its data-sharing SIMs and their details, as stored). Only active or blocked accounts with a rate plan are listed.
• NUMBER: range, employee, live and state. The name is the number without +45, followed by the user's name in brackets when the number belongs to a user. Only numbers in use are listed, and a number without a product of its own is on the customer's number rent product.
• DNS: no other properties - the domain is its _id and name.
• Invoice line (no type): the recurring invoice line as stored, e.g. description, unitPrice, unitWholesale, start, earliestStart, terminate, invoicedUntil, locked, recurrence and billingCustomer. A line without a name is named after its description.
• AI: units, always 1.
• SMARTWATCH: the smartwatch as stored (eid, model, state, number, createdAt, orderState, invoicedUntil and smartWatchSim, the SIM's details) and voiceAccount (the mobile account). Only active smartwatches are listed.
• DATA_SHARING_SIM: voiceAccount (the mobile account). The name is the account's name or number and the SIM's name or SIM number, separated by '' - ''.

The reseller view covers the reseller's active customers (its own customers, not those of its sub resellers). It counts every number that is not on a mobile account, whatever its state, and leaves out what a PBX user's product includes for free.

With format=csv (reseller view only) the response is a text/csv attachment (subscriptions.csv), one line per entry in the same order, with the columns: Productkode;Produktnavn;Antal;Forhandlerpris;Pris. Antal is units, Forhandlerpris sumWholesale and Pris sumPrice, written with two decimals and a decimal comma.

The customer view as a RESELLER sees it, with matchingProduct shortened:

[
  {
    "matchingProduct": {
      "stats": {
        "singles": 1,
        "hundreds": 0,
        "usedRanges": []
      },
      "_id": "650000000000000000000401",
      "type": "NUMBER_RENT",
      "name": "Number rent",
      "productCode": "NR-1",
      "price": 10,
      "wholesale": 8,
      "priceExtra": 5,
      "wholesaleExtra": 4,
      "price100": 300,
      "wholesale100": 250,
      "units": 2,
      "sumPrice": 15,
      "sumWholesale": 12
    },
    "subscriptions": [
      {
        "_id": "+4588888801",
        "customer": "650000000000000000000101",
        "name": "88888801 (Example User)",
        "range": null,
        "employee": "650000000000000000000201",
        "product": "650000000000000000000401",
        "live": "2026-01-05T00:00:00.000Z",
        "state": "IN_USE",
        "startDate": "2026-01-05T00:00:00.000Z",
        "type": "NUMBER"
      },
      {
        "_id": "+4588888802",
        "customer": "650000000000000000000101",
        "name": "88888802",
        "range": null,
        "employee": null,
        "product": "650000000000000000000401",
        "live": "2026-02-01T00:00:00.000Z",
        "state": "IN_USE",
        "startDate": "2026-02-01T00:00:00.000Z",
        "type": "NUMBER"
      }
    ],
    "name": "Number rent",
    "sumPrice": 15,
    "sumWholesale": 12,
    "units": 2
  },
  {
    "matchingProduct": {
      "_id": "650000000000000000000402",
      "type": "PBX_USER",
      "name": "PBX user",
      "productCode": "PBX-1",
      "price": 99,
      "wholesale": 60
    },
    "subscriptions": [
      {
        "_id": "650000000000000000000201",
        "customer": "650000000000000000000101",
        "name": "Example User",
        "accessLevel": "MANAGER",
        "product": "650000000000000000000402",
        "addonProducts": [],
        "invoicedUntil": "2026-10-31T00:00:00.000Z",
        "startDate": "2025-03-01T00:00:00.000Z",
        "type": "EMPLOYEE",
        "subscriptions": [],
        "price": 99,
        "wholesale": 60
      }
    ],
    "name": "PBX user",
    "sumPrice": 99,
    "sumWholesale": 60,
    "units": 1
  }
]

The reseller view, with matchingProduct shortened:

[
  {
    "matchingProduct": {
      "_id": "650000000000000000000501",
      "type": "PBX_USER",
      "name": "PBX user",
      "productCode": "PBX-1",
      "price": 99,
      "wholesale": 60
    },
    "sumPrice": 297,
    "sumWholesale": 180,
    "subscriptions": [
      {
        "sumPrice": 198,
        "sumWholesale": 120,
        "units": 2,
        "name": "Example Company East",
        "customer": "650000000000000000000101",
        "startDate": "2025-03-01T00:00:00.000Z"
      },
      {
        "sumPrice": 99,
        "sumWholesale": 60,
        "units": 1,
        "name": "Example Company North",
        "customer": "650000000000000000000102",
        "startDate": "2025-06-01T00:00:00.000Z"
      }
    ],
    "name": "PBX user",
    "units": 3
  }
]