Blacklists

All blacklist routes require applicationId and check access to that application.

Get blacklist metadata

GET /api/v1/panel/get-blacklist-metadata

Required scope: blacklists:read

curl "https://api.blazeauth.net/api/v1/panel/get-blacklist-metadata?applicationId=123456789" \
  -H "Authorization: Bearer $BLAZEAUTH_MANAGEMENT_API_KEY"

{
  "success": true,
  "message": "Successfully fetched blacklist metadata",
  "data": {
    "totalBlacklist": 7
  }
}

Get blacklist table

GET /api/v1/panel/get-blacklist-table

Required scope: blacklists:read

curl "https://api.blazeauth.net/api/v1/panel/get-blacklist-table?applicationId=123456789&currentPage=1" \
  -H "Authorization: Bearer $BLAZEAUTH_MANAGEMENT_API_KEY"

Optional searchParams is a URL-encoded JSON string:

{
  "searchString": "client-001",
  "categories": ["IPv4", "Client id"]
}

{
  "success": true,
  "message": "Successfully fetched blacklist table",
  "data": [
    {
      "id": "6001",
      "clientId": "client-001",
      "ipAddress": "203.0.113.10",
      "comment": "chargeback",
      "createdAt": "2026-05-12T09:00:00.000Z"
    }
  ],
  "totalPages": 1
}

Create blacklist

POST /api/v1/panel/create-blacklist

Required scope: blacklists:create

curl "https://api.blazeauth.net/api/v1/panel/create-blacklist?applicationId=123456789" \
  -X POST \
  -H "Authorization: Bearer $BLAZEAUTH_MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "clientId": "client-001",
    "ipAddress": "203.0.113.10",
    "comment": "chargeback"
  }'

Body field	Type	Required	Notes
`clientId`	string	Yes	Client identifier to block.
`ipAddress`	string \| null	Yes	IP address to block, or `null`.
`comment`	string \| null	Yes	Operator note, or `null`.

{
  "success": true,
  "message": "Successfully created blacklist entry.",
  "createdBlacklist": []
}

Edit blacklist

PATCH /api/v1/panel/edit-blacklist

Required scope: blacklists:update

curl "https://api.blazeauth.net/api/v1/panel/edit-blacklist?applicationId=123456789&blacklistId=6001" \
  -X PATCH \
  -H "Authorization: Bearer $BLAZEAUTH_MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "clientId": "client-001",
    "ipAddress": "203.0.113.10",
    "comment": "updated note"
  }'

Query field	Type	Required	Notes
`applicationId`	string	Yes	Target application id.
`blacklistId`	string	Yes	Blacklist row to update.

{
  "success": true,
  "message": "Successfully updated blacklist entry.",
  "createdBlacklist": []
}

Blacklist action

POST /api/v1/panel/blacklist-action

Required scope: blacklists:delete

curl "https://api.blazeauth.net/api/v1/panel/blacklist-action?applicationId=123456789" \
  -X POST \
  -H "Authorization: Bearer $BLAZEAUTH_MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "delete_blacklist",
    "blacklistId": "6001"
  }'

Action	Required fields
`delete_every_blacklist`	None
`delete_blacklist`	`blacklistId`

{
  "success": true,
  "message": "Action completed successfully."
}