Reference

Network port reference (service + risk note) API

Resolve a port number (and optional tcp/udp protocol) to its IANA-registered service, a plain description, the range category, and a security RISK note flagging ports commonly abused in attacks — the value-add over a bare IANA list. Answers 'what runs on port 3389', 'is port 23 dangerous', 'service for tcp/443', 'risk of exposing 6379'.

Price$0.01per request

MethodPOST

Route/v1/ref/port

StatusLive

MIME typeapplication/json

Rate limit60/minute

CacheNo cache

refportiananetworkservicesecurityrisktcp

API URLhttps://x402.hexl.dev/v1/ref/port

Integration docs

Example request

{
  "port": 3389
}

Example response

{
  "port": 3389,
  "protocol": "tcp",
  "service": "ms-wbt-server",
  "description": "Remote Desktop Protocol",
  "risk": "Top ransomware entry vector — never expose; use VPN",
  "flagged": true,
  "category": "registered",
  "found": true
}

Input schema

{
  "type": "object",
  "required": [
    "port"
  ],
  "properties": {
    "port": {
      "type": [
        "integer",
        "string"
      ],
      "examples": [
        3389,
        443,
        22
      ]
    },
    "protocol": {
      "type": "string",
      "enum": [
        "tcp",
        "udp"
      ],
      "examples": [
        "tcp"
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}