# GET /license/unregisteronline

> Unregister a DS Server installation online at the Text Control store by its serial number; the response is 200, or 400 with details when unregistering fails.

- **Product:** DS Server
- **Section:** Documentation
- **Kind:** Endpoint
- **Path:** DS Server > API Reference > Web API > Licensing > /unregisteronline > GET /license/unregisteronline
- **480 words**
- **Web URL:** https://docs.textcontrol.com/ds-server/reference/web-api/licensing/unregisteronline/get/
- **LLMs URL:** https://docs.textcontrol.com/ds-server/reference/web-api/licensing/unregisteronline/get/llms.txt
- **LLMs-Full URL:** https://docs.textcontrol.com/ds-server/reference/web-api/licensing/unregisteronline/get/llms-full.txt

---

`GET` `https://example.com/license/unregisteronline`

### Description

Unregisters DS Server online with the Text Control store based on a given serial number. The **Unregister** button on the **Online (Recommended)** tab of the admin portal's [Licensing](https://docs.textcontrol.com/ds-server/administration/licensing/llms-full.txt) page calls it.

### Examples

The following example unregisters DS Server online with the Text Control store.

```bash
# Request:
curl --request GET 'https://trial.dsserver.io/license/unregisteronline?serial=yourserialnumber' \
    --header 'Authorization: Basic e3t1c2VyX25hbWV9fTp7e3Bhc3N3b3JkfX0='
```

### Authorization

This endpoint supports the Basic authorization method:

#### Basic

| Header field | Description |
|---|---|
| Authorization | The username "admin" and your admin password are combined into a string separated by a colon, e.g.: admin:password. The resulting string is encoded using the RFC2045-MIME variant of Base64, except not limited to 76 char/line. The authorization method and a space i.e. "Basic " is then put before the encoded string. For example: `Authorization: Basic QWxhZGRpbjpPcGVuU2VzYW1l` |

### Request Parameters

| Name | Type | Value | Optional |
|---|---|---|---|
| serial | String | The given serial number of your DS Server installation. | no |

### Success Response

| Status | Description |
|---|---|
| 200 | On success, the HTTP status code in the response header is 200 (OK). |

### Error Response

| Status | Description |
|---|---|
| 401 | A 401 (Unauthorized) with an empty body and the header `WWW-Authenticate: Basic realm=Access to the Admin page` is returned, if the admin credentials are missing or wrong. |
| 400 | A 400 (Bad Request) is returned, if the unregistration failed. Details are listed in the returned error message. |

---

## Nearby

- **Previous:** [/license/unregisteronline](https://docs.textcontrol.com/ds-server/reference/web-api/licensing/unregisteronline/llms-full.txt)
- **Next:** [/license/register](https://docs.textcontrol.com/ds-server/reference/web-api/licensing/register/llms-full.txt)