> For the complete documentation index, see [llms.txt](https://docs.soraco.co/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.soraco.co/docs/how-to/http-api-examples.md).

# HTTP API examples

### Overview

This article provides some typical examples of how to use the QLM HTTP API to:

* Create license keys
* Check if a license key exists
* Renew the subscription of a license key

When using the QLM HTTP API, you must secure your calls with basic authentication (user/password). This is done by configuring an extension in the QLM Management Console / Manage Keys / 3rd Party extensions. If you're not using the HTTP API in the context of a specific e-commerce provider, we recommend using the QlmAuthenticationProvider extension.

For additional security, you can enable [QLM Strict Authentication ](https://docs.soraco.co/docs/how-to/how-to-invoke-a-qlm-http-method-that-requires-strict-authentication)for each method as needed.

<figure><img src="/files/ABHvDm5rm30176qzNLtV" alt=""><figcaption></figcaption></figure>

### Examples

#### Create a license key

To create a license key,  you must use the [GetActivationKeyWithExpiryDate ](/docs/api-reference/http-methods/getactivationkeywithexpirydate.md)method.

Example:

{% code overflow="wrap" %}

```http
http://localhost/QlmLicenseServer/qlmservice.asmx/GetActivationKeyWithExpiryDate?is_productid=1&is_majorversion=1&is_minorversion=0&is_vendor=QlmAuthenticationProvider&is_expduration=10&is_user=qlmdemo&is_pwd=xxx&orderNumber=1234&subscriptionid=5678&is_licensemodel=subscription
```

{% endcode %}

#### Check if a license exists, given  an order ID

To check if a license key exists,  you must use the [ ](/docs/api-reference/http-methods/getactivationkeywithexpirydate.md)[RetrieveActivationKeyHttp](/docs/api-reference/http-methods/retrieveactivationkeyhttp.md) method.

Example:

{% code overflow="wrap" %}

```http
http://localhost/QlmLicenseServer/qlmservice.asmx/RetrieveActivationKeyHttp?&is_vendor=QlmAuthenticationProvider&is_user=qlmdemo&is_pwd=xxx&is_orderid=1234
```

{% endcode %}

#### Renew a subscription

To renew the subscription of a license key,  you must use the [ ](/docs/api-reference/http-methods/getactivationkeywithexpirydate.md)[RenewSubscriptionHttp](/docs/api-reference/http-methods/renewsubscriptionhttp.md) method.

Example:

{% code overflow="wrap" %}

```http
http://localhost/QlmLicenseServer/qlmservice.asmx/RenewSubscriptionHttp?is_vendor=QlmAuthenticationProvider&is_user=qlmdemo&is_pwd=xxx&subscriptionid=5678
```

{% endcode %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.soraco.co/docs/how-to/http-api-examples.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.