HWID Bans

HWID ban management endpoints

List all HWID bans

get

Authorizations

bearerAuth

AuthorizationstringRequired

API Key with rest-api:* scope

Query parameters

limitinteger · min: 1 · max: 500OptionalDefault: 100

offsetintegerOptionalDefault: 0

Responses

200

List of HWID bans

application/json

totalintegerOptional

limitintegerOptional

offsetintegerOptional

get

/hwid-bans

HTTPcURLJavaScriptPython

GET /api/v2/hwid-bans HTTP/1.1
Host: api.jnkie.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

List of HWID bans

{
  "hwid_bans": [
    {
      "id": 1,
      "hwid": "text",
      "reason": "text",
      "created_at": "2026-03-11T10:29:51.149Z",
      "expires_at": "2026-03-11T10:29:51.149Z"
    }
  ],
  "total": 1,
  "limit": 1,
  "offset": 1
}

Ban a HWID

post

Authorizations

bearerAuth

AuthorizationstringRequired

API Key with rest-api:* scope

Body

application/json

hwidstring · min: 3 · max: 128Required

reasonstring · max: 255Optional

expires_atstring · date-timeOptional

ISO 8601 datetime for temporary ban, null for permanent

invalidate_keysbooleanOptional

Also invalidate all keys with this HWID

Default: false

Responses

200

HWID banned

application/json

keys_invalidatedbooleanOptional

post

/hwid-bans

HTTPcURLJavaScriptPython

POST /api/v2/hwid-bans HTTP/1.1
Host: api.jnkie.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 95

{
  "hwid": "text",
  "reason": "text",
  "expires_at": "2026-03-11T10:29:51.149Z",
  "invalidate_keys": false
}

200

HWID banned

{
  "hwid_ban": {
    "id": 1,
    "hwid": "text",
    "reason": "text",
    "created_at": "2026-03-11T10:29:51.149Z",
    "expires_at": "2026-03-11T10:29:51.149Z"
  },
  "keys_invalidated": true
}

Get a specific HWID ban

get

Authorizations

bearerAuth

AuthorizationstringRequired

API Key with rest-api:* scope

Path parameters

banIdintegerRequired

Responses

200

HWID ban details

application/json

404

HWID ban not found

get

/hwid-bans/{banId}

HTTPcURLJavaScriptPython

GET /api/v2/hwid-bans/{banId} HTTP/1.1
Host: api.jnkie.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "hwid_ban": {
    "id": 1,
    "hwid": "text",
    "reason": "text",
    "created_at": "2026-03-11T10:29:51.149Z",
    "expires_at": "2026-03-11T10:29:51.149Z"
  }
}

Update a HWID ban

put

Authorizations

bearerAuth

AuthorizationstringRequired

API Key with rest-api:* scope

Path parameters

banIdintegerRequired

Body

application/json

hwidstring · min: 3 · max: 128Optional

Change the banned HWID

reasonstring · max: 255Optional

expires_atstring · date-time · nullableOptional

Set to null to make permanent

Responses

200

HWID ban updated

application/json

404

HWID ban not found

put

/hwid-bans/{banId}

HTTPcURLJavaScriptPython

PUT /api/v2/hwid-bans/{banId} HTTP/1.1
Host: api.jnkie.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 71

{
  "hwid": "text",
  "reason": "text",
  "expires_at": "2026-03-11T10:29:51.149Z"
}

{
  "hwid_ban": {
    "id": 1,
    "hwid": "text",
    "reason": "text",
    "created_at": "2026-03-11T10:29:51.149Z",
    "expires_at": "2026-03-11T10:29:51.149Z"
  }
}

Unban a HWID by ban ID

delete

Authorizations

bearerAuth

AuthorizationstringRequired

API Key with rest-api:* scope

Path parameters

banIdintegerRequired

Responses

200

HWID unbanned

application/json

successbooleanOptional

unbanned_hwidstringOptional

404

HWID ban not found

delete

/hwid-bans/{banId}

HTTPcURLJavaScriptPython

DELETE /api/v2/hwid-bans/{banId} HTTP/1.1
Host: api.jnkie.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "unbanned_hwid": "text"
}

Unban a HWID by HWID value

delete

Authorizations

bearerAuth

AuthorizationstringRequired

API Key with rest-api:* scope

Path parameters

hwidstringRequired

Responses

200

HWID unbanned

application/json

successbooleanOptional

unbanned_hwidstringOptional

404

HWID ban not found

delete

/hwid-bans/by-hwid/{hwid}

HTTPcURLJavaScriptPython

DELETE /api/v2/hwid-bans/by-hwid/{hwid} HTTP/1.1
Host: api.jnkie.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "unbanned_hwid": "text"
}

Check if a HWID is banned

get

Authorizations

bearerAuth

AuthorizationstringRequired

API Key with rest-api:* scope

Path parameters

hwidstringRequired

Responses

200

Ban status

application/json

is_bannedbooleanOptional

hwidstringOptional

get

/hwid-bans/check/{hwid}

HTTPcURLJavaScriptPython

GET /api/v2/hwid-bans/check/{hwid} HTTP/1.1
Host: api.jnkie.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Ban status

{
  "is_banned": true,
  "hwid": "text",
  "hwid_ban": {
    "id": 1,
    "hwid": "text",
    "reason": "text",
    "created_at": "2026-03-11T10:29:51.149Z",
    "expires_at": "2026-03-11T10:29:51.149Z"
  }
}