Authentication
Authentication
Quick Start
- Get your sellerkey from your AuthGuards dashboard.
- Include
sellerkey=YOUR_SELLER_KEYas a query parameter in every API request. - All endpoints require a valid sellerkey with Seller privileges.
Example Requests
curl "https://api.authguards.com/api/?ag=getprojects&sellerkey=YOUR_SELLER_KEY"
Authentication Parameter
| Parameter | Type | Description |
|---|---|---|
| sellerkey | string | Your API key (requires Seller role) |
Possible Authentication Errors
| Error Message | Explanation |
|---|---|
| Missing sellerkey | No sellerkey parameter was provided in the request. |
| Invalid sellerkey | The provided sellerkey does not match any project in the system. |
| Your account does not have Seller privileges. | The sellerkey is valid, but the account is not a Seller (upgrade required). |
Authentication Error Example
{
"success": false,
"message": "Missing sellerkey"
}
// or
{
"success": false,
"message": "Invalid sellerkey"
}
// or
{
"success": false,
"message": "Your account does not have Seller privileges. [Upgrade your plan](https://authguards.com/upgrade) to unlock full API access."
}
Rate Limits
Rate Limits
The API is rate-limited to ensure stability and prevent abuse.
- Default rate limit: 120 requests per minute per seller key
- When exceeded, requests will return HTTP 429 with a Retry-After header
Create License
POST
Create License Key
https://api.authguards.com/api/?ag=createkey
| Parameter | Type | Description |
|---|---|---|
| duration | string |
License duration. Valid values:
|
| pattern (optional) | string | Custom key pattern (e.g., ****-****-****-****) |
| hwid_lock (optional) | integer | Enable HWID lock (0 or 1) |
| amount (optional) | integer | Number of keys to generate (1-15, default: 1) |
{
"success": true,
"license_key": "XXXX-XXXX-XXXX-XXXX"
// Or when amount > 1:
"license_keys": [
"XXXX-XXXX-XXXX-XXXX",
"YYYY-YYYY-YYYY-YYYY"
]
}
Get License Info
GET Get License Info
https://api.authguards.com/api/?ag=keyinfo
| Parameter | Type | Description |
|---|---|---|
| license_key | string | The license key to check |
{
"success": true,
"key_info": {
"license_key": "XXXX-XXXX-XXXX-XXXX",
"expiry_date": "2024-12-31 23:59:59",
"ip_address": "1.2.3.4",
"status": "Active",
"banned": false,
"created_at": "2024-01-01 12:00:00",
"last_seen": "2024-01-15 15:30:00",
"discord_accounts": [
{
"id": "123456789",
"username": "user#1234"
}
]
}
}
Update License
PUT Update License
https://api.authguards.com/api/?ag=none
| Parameter | Type | Description |
|---|---|---|
| license_key | string | The license key to update |
| expires_at (optional) | string | New expiry date |
{
"success": true,
"message": "License updated"
}
Delete License
DELETE Delete License
https://api.authguards.com/api/?ag=soon
| Parameter | Type | Description |
|---|---|---|
| license_key | string | The license key to delete |
{
"success": true,
"message": "License deleted"
}
Ban License
POST Ban License
https://api.authguards.com/api/?ag=ban
| Parameter | Type | Description |
|---|---|---|
| license_key | string | The license key to ban |
{
"success": true,
"message": "License banned"
}
Unban License
POST Unban License
https://api.authguards.com/api/?ag=unban
| Parameter | Type | Description |
|---|---|---|
| license_key | string | The license key to unban |
{
"success": true,
"message": "License unbanned"
}
Reset License
POST Reset License
https://api.authguards.com/api/?ag=resetkey
| Parameter | Type | Description |
|---|---|---|
| license_key | string | The license key to reset |
{
"success": true,
"message": "License reset"
}
Create Sub-Account
POST Create Sub-Account
https://api.authguards.com/api/?ag=createsubacc
| Parameter | Type | Description |
|---|---|---|
| reseller_name | string | Username (letters and numbers only) |
| reseller_email | string | Valid email address |
| reseller_password | string | Account password |
| reseller_project_id | string | Project ID to assign |
| reseller_balance | number | Initial balance (must be >= 0) |
{
"success": true,
"message": "Sub-account created successfully."
}
List Sub-Accounts
GET List Sub-Accounts
https://api.authguards.com/api/?ag=getallsubaccounts
| Parameter | Type | Description |
|---|---|---|
| project_id (optional) | string | Filter by project ID |
{
"success": true,
"subaccounts": [
{"name": "user1", "email": "user1@example.com"}
]
}
Update Sub-Account
PUT Update Sub-Account
https://api.authguards.com/api/?ag=updatesubacc
| Parameter | Type | Description |
|---|---|---|
| sub_name | string | Sub-account username |
| new_email (optional) | string | New email address |
{
"success": true,
"message": "Sub-account updated"
}
Delete Sub-Account
DELETE Delete Sub-Account
https://api.authguards.com/api/?ag=deletesubacc
| Parameter | Type | Description |
|---|---|---|
| sub_name | string | Sub-account username |
{
"success": true,
"message": "Sub-account deleted"
}
Ban Sub-Account
POST Ban Sub-Account
https://api.authguards.com/api/?ag=bansubacc
| Parameter | Type | Description |
|---|---|---|
| sub_name | string | Sub-account username |
{
"success": true,
"message": "Sub-account banned"
}
Unban Sub-Account
POST Unban Sub-Account
https://api.authguards.com/api/?ag=unbansubacc
| Parameter | Type | Description |
|---|---|---|
| sub_name | string | Sub-account username |
{
"success": true,
"message": "Sub-account unbanned"
}
Reset Sub-Account Password
POST Reset Sub-Account Password
https://api.authguards.com/api/?ag=resetsubaccpw
| Parameter | Type | Description |
|---|---|---|
| sub_name | string | Sub-account username |
{
"success": true,
"message": "Sub-account password reset"
}
Get Sub-Account Stats
GET Get Sub-Account Stats
https://api.authguards.com/api/?ag=getsubaccstats
| Parameter | Type | Description |
|---|---|---|
| sub_name | string | Sub-account username |
{
"success": true,
"stats": {
"total_licenses": 10,
"active_licenses": 8,
"banned_licenses": 2,
"total_subaccounts": 5,
"active_subaccounts": 4,
"banned_subaccounts": 1
}
}
Set Sub-Account Projects
POST Set Sub-Account Projects
https://api.authguards.com/api/?ag=setsubaccprojects
| Parameter | Type | Description |
|---|---|---|
| sub_name | string | Sub-account username |
| project_ids | array | Array of project IDs to assign |
{
"success": true,
"message": "Sub-account projects updated"
}
Set Sub-Account Balance
POST Set Sub-Account Balance
https://api.authguards.com/api/?ag=setsubaccbalance
| Parameter | Type | Description |
|---|---|---|
| sub_name | string | Sub-account username |
| balance | number | New balance (must be >= 0) |
{
"success": true,
"message": "Sub-account balance updated"
}
Get Sub-Account Balance
GET Get Sub-Account Balance
https://api.authguards.com/api/?ag=getsubaccbalance
| Parameter | Type | Description |
|---|---|---|
| sub_name | string | Sub-account username |
{
"success": true,
"balance": 100.50
}
Link Discord
POST Link Discord
https://api.authguards.com/api/?ag=linkdiscord
| Parameter | Type | Description |
|---|---|---|
| license_key | string | The license key to link |
| discord_id | string | Your Discord ID (e.g., 123456789012345678) |
| discord_username | string | Your Discord username (e.g., user#1234) |
{
"success": true,
"message": "Discord linked successfully."
}
Unlink Discord
POST Unlink Discord
https://api.authguards.com/api/?ag=unlinkdiscord
| Parameter | Type | Description |
|---|---|---|
| license_key | string | The license key to unlink |
{
"success": true,
"message": "Discord unlinked successfully."
}
Get Discord Info
GET Get Discord Info
https://api.authguards.com/api/?ag=getdiscordinfo
| Parameter | Type | Description |
|---|---|---|
| license_key | string | The license key to check |
{
"success": true,
"discord_info": {
"license_key": "XXXX-XXXX-XXXX-XXXX",
"discord_id": "123456789012345678",
"discord_username": "user#1234",
"linked_at": "2024-01-01 10:00:00"
}
}
Get Projects
GET Get Projects
https://api.authguards.com/api/?ag=getprojects
| Parameter | Type | Description |
|---|---|---|
| (none) | - | Just authenticate with your sellerkey |
{
"success": true,
"projects": [
{ "id": "123", "name": "Project Alpha" },
{ "id": "456", "name": "Project Beta" }
]
}
Show Blacklist
GET Show Blacklist
https://api.authguards.com/api/?ag=showblacklist
| Parameter | Type | Description |
|---|---|---|
| (none) | - | Just authenticate with your sellerkey |
{
"success": true,
"blacklist": [
{ "type": "ip", "value": "1.2.3.4", "reason": "Abuse", "created_at": "2024-07-21 12:00:00" },
{ "type": "hwid", "value": "S-1-5-21-...", "reason": null, "created_at": "2024-07-21 12:01:00" }
]
}
Add Blacklist
POST Add Blacklist
https://api.authguards.com/api/?ag=addblacklist
| Parameter | Type | Description |
|---|---|---|
| type | string | "ip" or "hwid" |
| value | string | IP address or HWID to blacklist |
| reason (optional) | string | Reason for blacklisting |
{
"success": true,
"message": "Added to blacklist."
}
Remove Blacklist
DELETE Remove Blacklist
https://api.authguards.com/api/?ag=removeblacklist
| Parameter | Type | Description |
|---|---|---|
| type | string | "ip" or "hwid" |
| value | string | IP address or HWID to remove |
{
"success": true,
"message": "Removed from blacklist."
}
Find Key by Discord
GET Find Key by Discord
https://api.authguards.com/api/?ag=findkeybydiscord
| Parameter | Type | Description |
|---|---|---|
| discord_id | string | Discord user ID to search for |
{
"success": true,
"results": [
{
"license_key": "XXXX-XXXX-XXXX-XXXX",
"created_at": "2024-07-21 12:00:00",
"expiry_date": "2024-08-21 12:00:00",
"status": "Active",
"discord_username": "user#1234"
}
]
}