Table of Contents

API : Integration : ALSO Available Services List

Introduction

This request lists the ALSO services available to a customer's reseller, with ALSO's monthly purchase price and suggested retail price.

Request

URL https://api.telecomx.dk/integration/also/availableServices
Method GET
Access level RESELLER if the customer belongs to the reseller or a sub reseller.
RESELLER_ADMIN or ADMIN.
The customer's reseller must have the External licenses feature.
Query customer Id [optional] Id of the customer, defaults to the user's own customer. The services of the customer's reseller are listed - or of the customer itself when it is a reseller
displayName String [optional] Only list services whose name contains this text, not case sensitive, max. 256 characters

Query examples

GET https://api.telecomx.dk/integration/also/availableServices
GET https://api.telecomx.dk/integration/also/availableServices?customer=650000000000000000000001&displayName=business

Response

Json array of service objects
serviceName String The service's id in ALSO
displayName String The service's name
wholesalePrice Number Monthly purchase price. Absent when ALSO has no monthly charge for the service
price Number Suggested monthly retail price. Absent when ALSO has no monthly charge for the service

Example

[
  {
    "serviceName": "<ALSO_SERVICE_ID>",
    "displayName": "Microsoft 365 Business Standard",
    "wholesalePrice": 75.5,
    "price": 99
  }
]

Errors

Error code Message Description
422 <property> Invalid input for the named property - the request body, query or URL parameter failed validation
403 access_denied Insufficient access level
404 not_found Item not found - returned for every failure: the customer or its reseller is not found, the user has no access to the reseller, the reseller has no ALSO integration, or ALSO could not be reached
500 internal_error <Unspecified>