1--- 2layout: "api" 3page_title: "/sys/license - HTTP API" 4sidebar_title: "<code>/sys/license</code>" 5sidebar_current: "api-http-system-license" 6description: |- 7 The `/sys/license` endpoint is used to view and update the license used in 8 Vault. 9--- 10 11# `/sys/license` 12 13~> **Enterprise Only** – These endpoints require Vault Enterprise. 14 15The `/sys/license` endpoint is used to view and update the license used in 16Vault. 17 18## Read License 19 20This endpoint returns information about the currently installed license. 21 22| Method | Path | Produces | 23| :------- | :--------------------------- | :--------------------- | 24| `GET` | `/sys/license` | `200 application/json` | 25 26### Sample Request 27 28``` 29$ curl \ 30 --header "X-Vault-Token: ..." \ 31 http://127.0.0.1:8200/v1/sys/license 32``` 33 34### Sample Response 35 36```json 37{ 38 "data": { 39 "expiration_time": "2017-11-14T16:34:36.546753-05:00", 40 "features": [ 41 "UI", 42 "HSM", 43 "Performance Replication", 44 "DR Replication" 45 ], 46 "license_id": "temporary", 47 "start_time": "2017-11-14T16:04:36.546753-05:00" 48 }, 49 "warnings": [ 50 "time left on license is 29m33s" 51 ] 52} 53``` 54 55## Install License 56 57This endpoint is used to install a license into Vault. 58 59| Method | Path | Produces | 60| :------- | :--------------------------- | :--------------------- | 61| `PUT` | `/sys/license` | `204 (empty body)` | 62 63### Parameters 64 65- `text` `(string: <required>)` – The text of the license. 66 67*DR Secondary Specific Parameters* 68 69 - `dr_operation_token` `(string: <required>)` - DR operation token used to authorize this request. 70 71 72### Sample Payload 73 74```json 75{ 76 "text": "01ABCDEFG..." 77} 78``` 79 80### Sample Request 81 82``` 83$ curl \ 84 --header "X-Vault-Token: ..." \ 85 --request PUT \ 86 --data @payload.json \ 87 http://127.0.0.1:8200/v1/sys/license 88``` 89