---
title: "LicenceList"
method: POST
path: "/licences"
tags: ["LicenceList"]
---

# LicenceList

`POST /licences`

## Headers

- `Api-Version` 2, required
- `Api-Application` string, required
- `Api-Company` string, required
- `Api-Branding` string

## Request body

- object[]
  - `couponCode` string, required

## Response `201`

Success response. Data could be an object instead of a list when one value is returned

- object
  - `status` string, required
  - `type` string, required
  - `moreAfter` string, nullable
  - `data` object[], required
    - `publicId` string
    - `type` object
      - `publicId` string
      - `usageType` 'advanced-user-management' | 'agent-registration-profile' | 'agent-templates' | 'alarming' | 'api-integrations' | 'app-engine-level-1' | 'app-engine-level-2' | 'app-engine-level-3' | 'asset-management' | 'card-view' | 'connection-monitoring' | 'controlled-devices' | 'custom-branding' | 'custom-domain' | 'custom-fields' | 'custom-legal' | 'custom-legal-legacy' | 'custom-sso' | 'edge-app-management' | 'ixagent' | 'landing-page' | 'live-data' | 'logging' | 'm2m-cloud-cluster' | 'main-pages' | 'mobile-app' | 'mqtt-device' | 'object-storage' | 'premium-branding' | 'rdp' | 'remote-access' | 'reporting' | 'request-access' | 'rtsp' | 'scim' | 'session-recording' | 'sla' | 'ssh' | 'subgroups' | 'temporary-access' | 'vpn-access-rule' | 'vpn-usage'
      - `companyLimit` integer, nullable
      - `scope` 'agent' | 'company'
    - `serialNumber` string
    - `expiresOn` string, date-time, nullable
    - `activated` boolean
    - `trial` boolean
    - `value` string, nullable
    - `locked` boolean, nullable
    - `maxRetentionPolicy` string, nullable
    - `agent` object, nullable
      - `publicId` string
      - `name` string, nullable
      - `deviceId` string
      - `type` object
        - `publicId` string
      - `location` object
        - `name` string
        - `latitude` string
        - `longitude` string
      - `geoLocation` object
        - `latitude` string
        - `longitude` string
        - `country` string
        - `city` string
      - `custom` object
    - `hasAgent` boolean
    - `agentType` object, nullable
      - `publicId` string
      - `additionalSubnets` boolean
      - `allowDataPublishing` boolean
      - `allowDemoDevice` boolean
      - `allowTemplating` boolean
      - `allowReboot` boolean
      - `configPush` boolean
      - `configFileFormat` integer
      - `customServers` boolean
      - `deviceIdFormat` string
      - `httpProxyPort` integer, nullable
      - `latestFirmwareFile` object
        - `publicId` string
        - `name` string
        - `description` string
        - `code` string
        - `notes` string
        - `agentType` object
          - `publicId` string
        - `type` 'firmware'
        - `latest` boolean
        - `custom` object
      - `name` string
      - `offlineConfiguration` boolean
      - `openvpnConfigMultiUse` boolean
      - `purchasePrice` object
        - `gratis` boolean
      - `router` boolean
      - `stunnelSupport` boolean
      - `wanPortForwardings` boolean
      - `custom` object
      - `hasSecondWanPort` boolean
    - `bundle` object, nullable
      - `publicId` string
      - `name` string

## Other responses

- `4XX` — 4XX error response

---

[API](https://skmtc.net/ixon/apis/ixon-api.md) · [All operations](https://skmtc.net/ixon/apis/ixon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ixon/ixon-api/versions/7875dc33d41f/schema)