> For the complete documentation index, see [llms.txt](https://docs.happ-proxy.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.happ-proxy.com/getting-started/provider-id.md).

# 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}
   ```