# Provider ID

ProviderID is a unique identifier that links your subscription to your account on our site. It unlocks advanced app functionality and allows precise tracking of active devices.

***

### **How it Works**

No more than once per day, the app sends a GET request to:

```
https://check.happ-proxy.com/provider?id={ProviderID}
```

The request includes:

* **providerid** — your unique identifier
* **domain hash** of the subscription’s source
* **HWID** of the device
* **operating system name and version**

The domain hash guarantees that the ProviderID is bound to the specific subscription domain and prevents it from being used on other sites or in other subscriptions.

***

### **Ways to Provide Your ProviderID**

You can include the ProviderID in your subscription in three ways:

1. **In the URL** (query parameter)

   ```
   https://your-domain.com/sub/123#?providerid={ProviderID}
   ```
2. **In the subscription body** (as a comment)

   ```
   #providerid {ProviderID}
   vless://70cc48c5‑b2f4…
   vmess://zkIAU1JitkI…
   ```
3. **In the HTTP response header**

   ```
   HTTP/2 200 OK
   date: Wed, 14 Apr 2025 10:00:00 GMT
   content-type: application/json
   content-length: 3798
   content-disposition: attachment; filename="213"
   providerid: {ProviderID}
   ```


---

# Agent Instructions: 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.happ-proxy.com/getting-started/provider-id.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.
