## License (`license`)

License status and validity of this installation; once locked after expiry, new sites, forwardings and nodes cannot be created.

Authentication: User · Docs: https://www.gocdn888.com/en/docs/api/license

### GET `/api/v2/license/features`

List paid feature availability · Authentication: User

```sh
curl "https://panel.example.com/api/v2/license/features" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

License object:

| Field | Type | Required | Description |
|---|---|---|---|
| `customer` | string |  | Customer name on the license. |
| `expires_at` | string |  | Validity end of the last accepted license. |
| `features` | LicenseFeature[] |  | Features enabled by the license. |
| `grace_until` | string |  | End of the grace period; after it, creating new items is locked. After a disable notice, the earlier of this and first notice + 24 hours. |
| `install_id` | string |  | Installation ID (install key fingerprint). |
| `last_ok_at` | string |  | Time of the last successful fetch; omitted if there has never been one. |
| `locked` | boolean |  | Whether create-type operations (creating sites, TCP/UDP forwardings, IP sites, nodes, node enrollment tokens and approvals) are locked. |
| `readonly_days` | integer |  | Read-only buffer in days (set by the provider, 7 if not set). For this many days after a protection feature's not_after, waf_enhanced is read-only and xdp and l2 are frozen; after that they degrade with settings kept, and renewing restores them right away. |
| `reason` | string |  | Why the last fetch failed (protocol error code, http_<status>:<code>, unreachable, clock_behind); empty on success. After a disable notice (within the buffer or denied), the reason it was disabled. |
| `status` | string |  | pending: never fetched successfully (within first-run grace); active: last fetch succeeded; grace: last fetch failed (including the 24-hour buffer after a disable notice) but still within grace; locked: grace expired; denied: this installation was disabled by the platform operator and the 24-hour buffer has passed; it recovers on the next fetch once the operator lifts it. Values: ["pending","active","grace","locked","denied"] |
| `stop_at` | string |  | When a trial stops serving (plan expiry + 7 days); present only when trial is true. |
| `trial` | boolean |  | Whether the last accepted license is a trial license (not sent by the provider means not a trial). Trials get no 7/3/1-day expiry reminders. At stop_at every node stops serving with settings kept; buying a full license or moving stop_at later restores service within about a minute. |
| `trial_stopped` | boolean |  | Whether the trial has reached stop_at by now, judged by the latest time the controller has seen (turning the local clock back does not restore service early). false when not a trial. |
