Check which addresses are blocked

GET/streams/blocked-ips/match/

read Read: looks, changes nothing. Scopes

For up to 200 address values, the ones blocked now and the block holding each, as {address: block}.

Query parameters

addressstring[]required
An address to check; repeat for more.

Response

200 OK

object

Errors

401 No credential, or one that is wrong, expired or revoked.
403 The account, or the key's or app's scopes, may not do this.
429 Slow down: wait the seconds in the Retry-After header, then try again.

What each error means

cURL

curl 'https://panel.example.com/streams/blocked-ips/match/?address=203.0.113.10' \
  -H "Authorization: Bearer $MINIMUS_API_KEY"

Python

import os
import requests

response = requests.get(
    "https://panel.example.com/streams/blocked-ips/match/?address=203.0.113.10",
    headers={"Authorization": f"Bearer {os.environ['MINIMUS_API_KEY']}"},
)
response.raise_for_status()
print(response.json())

JavaScript

const response = await fetch('https://panel.example.com/streams/blocked-ips/match/?address=203.0.113.10', {
  method: 'GET',
  headers: { Authorization: `Bearer ${process.env.MINIMUS_API_KEY}` },
});
if (!response.ok) throw new Error(`${response.status}`);
console.log(await response.json());

Response 200

{
  "key": {
    "id": 1,
    "network": "string",
    "address": "203.0.113.10",
    "reason": "string",
    "expires_at": "2026-11-13T12:00:00Z",
    "trigger": {
      "0": "s",
      "1": "i",
      "2": "g",
      "3": "n",
      "4": "i",
      "5": "n"
    },
    "times": 1,
    "ended": true,
    "lifted_at": "2026-11-13T12:00:00Z",
    "lifted_by_username": "alice",
    "created_by_username": "alice",
    "created_at": "2026-11-13T12:00:00Z"
  }
}

Check which addresses are blocked

Query parameters#

Response#

200 OK

Errors#

Query parameters

Response

Errors