Get Blacklisted IPs API

Retrieve the list of IP addresses that have been blocked from accessing the VPN service

Security

Get Blacklisted IPs API

Access the complete list of IP addresses that have been blacklisted from the VPN service. Monitor blocked addresses for security management.

Blocked IPs

All banned addresses.

Security List

Access control records.

Audit Trail

Review blocked entries.


Endpoint Overview

QUERY/graphql

Retrieve all IP addresses that have been added to the blacklist and are blocked from accessing VPN services.

Authentication:Bearer Token
Required scopes:admin

GraphQL Query

query getBlacklistedIPs {
  getBlacklistedIPs {
    id
    ipAddress
    reason
    createdAt
    createdBy
  }
}

HTTP Request:

curl -X POST https://api.orbnet.com/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{
    "query": "query getBlacklistedIPs { getBlacklistedIPs { id ipAddress reason createdAt } }"
  }'

Response

200Blacklist Retrieved Successfully
{
  "data": {
    "getBlacklistedIPs": [
      {
        "id": "1",
        "ipAddress": "192.168.1.100",
        "reason": "Suspicious activity detected",
        "createdAt": "2024-01-15T10:30:00Z",
        "createdBy": "admin"
      },
      {
        "id": "2",
        "ipAddress": "10.0.0.50",
        "reason": "Abuse report verified",
        "createdAt": "2024-01-14T08:00:00Z",
        "createdBy": "admin"
      },
      {
        "id": "3",
        "ipAddress": "172.16.0.25",
        "reason": "Multiple failed login attempts",
        "createdAt": "2024-01-13T14:45:00Z",
        "createdBy": "system"
      }
    ]
  }
}
200Empty Blacklist
{
  "data": {
    "getBlacklistedIPs": []
  }
}

Response Fields

idID!

Unique identifier for the blacklist entry.

ipAddressString!

The blocked IP address.

reasonString

Reason for adding the IP to the blacklist.

createdAtDateTime

When the IP was blacklisted.

createdByString

Admin or system that added the entry.


Security Features

Abuse Prevention

Block malicious actors.

Access Control

Restrict by IP address.

Threat Response

Quick threat mitigation.

Audit Logging

Track security actions.



Admin Only

This endpoint is restricted to admin users. Blacklisted IPs are immediately blocked from all VPN connections.

Block a Suspicious IP

Add IP addresses to the blacklist to prevent malicious access.

Add to Blacklist