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                         |
23| :--------------------------- | :--------------------- |
24| `GET`    | `/sys/license`                |
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                         |
60| :--------------------------- | :--------------------- |
61| `PUT`    | `/sys/license`                |
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