Skip to content
You're viewing documentation for v2026.11.8-beta. It may be out of date.Go to latest
TimescaleDB Enterprise
Esc
↑↓navigate↵open⌘Jpreview

Get current license status

Returns the installed licenses, the license consumption, whether the console enforces licenses, and whether a trial is available.

GET/api/v1/license
Authorization
tse_sessionAPI key · cookierequired
Responses
200

OK

demo_license_enforcedboolean

Demo mode only: licensing is enforced for services on demo servers. Real servers are always enforced

enforcingbooleanrequired
license_consumptionLicenseConsumption
Show properties
servicesLicenseConsumptionService[]required
Show properties
Array of LicenseConsumptionService
idstringrequired
license_filestringrequired
license_labelstring
max_memory_gbinteger<int64>required
max_vcpusinteger<int64>required
namestringrequired
notestring
serversinteger<int64>required
tierstringrequired
totalsLicenseConsumptionTotal[]required
Show properties
Array of LicenseConsumptionTotal
countinteger<int64>required
tierstringrequired
licensesLicenseEntry[]required
Show properties
Array of LicenseEntry
detailstring
entitlementsstring[]required
expirystring<date-time>
filestringrequired
idstring
issuedstring<date-time>
max_machinesinteger<int64>required
max_memory_gbinteger<int64>required
max_vcpusinteger<int64>required
namestring
renewableboolean

The console checks this license out online, so the refresh button gets a new term. false: the license was added as a file

serviceServiceRef
Show properties
idstringrequired
namestringrequired
server_countinteger<int64>required
statusstringrequired
tierstring
trial_resettableboolean
trial_availablebooleanrequired
default

Error

codestring

Stable code of the refusal, when the route has codes

detailsstring[]

Additional detail, e.g. per-field validation failures

errorstringrequired

Human-readable error message

Request
curl -X GET 'https://console.example.com/api/v1/license' \
  -H 'Cookie: tse_session=YOUR_API_KEY' \
  -H 'Accept: application/json'
Response
{
  "demo_license_enforced": true,
  "enforcing": true,
  "license_consumption": {
    "services": [
      {
        "id": "string",
        "license_file": "string",
        "license_label": "string",
        "max_memory_gb": 0,
        "max_vcpus": 0,
        "name": "string",
        "note": "string",
        "servers": 0,
        "tier": "string"
      }
    ],
    "totals": [
      {
        "count": 0,
        "tier": "string"
      }
    ]
  },
  "licenses": [
    {
      "detail": "string",
      "entitlements": [
        "string"
      ],
      "expiry": "2019-08-24T14:15:22Z",
      "file": "string",
      "id": "string",
      "issued": "2019-08-24T14:15:22Z",
      "max_machines": 0,
      "max_memory_gb": 0,
      "max_vcpus": 0,
      "name": "string",
      "renewable": true,
      "service": {
        "id": "string",
        "name": "string",
        "server_count": 0
      },
      "status": "string",
      "tier": "string",
      "trial_resettable": true
    }
  ],
  "trial_available": true
}