Network Port

GET/v0/net/port

Validates a network port number (0–65535). Returns whether it is a well-known port and, if so, the associated service name, protocol, and description.

Try it

Query Parameters

Parameter	Type	Required	Description
value	string	Yes	Port number as a numeric string (e.g. `80`, `443`, `8080`)

Example Requests

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.isvalid.dev/v0/net/port?value=443"

Response Fields

Field	Type	Description
valid	boolean	Whether the value is a valid port number (0–65535)
port	number	Numeric port value
range	string	Port range category: `well-known` (0–1023), `registered` (1024–49151), or `dynamic` (49152–65535)
wellKnown	boolean	Whether the port is a well-known/registered service port
serviceName	string \| null	Service name (e.g. HTTP, HTTPS, SSH)
protocol	string \| null	Transport protocol (TCP, UDP, or TCP/UDP)
description	string \| null	Human-readable description of the service

Example Response — well-known port

{
  "valid": true,
  "port": 443,
  "range": "well-known",
  "wellKnown": true,
  "serviceName": "HTTPS",
  "protocol": "TCP",
  "description": "HTTP over TLS/SSL"
}

Example Response — valid but not well-known

{
  "valid": true,
  "port": 12345,
  "range": "registered",
  "wellKnown": false,
  "serviceName": null,
  "protocol": null,
  "description": null
}

Example Response — invalid

{
  "valid": false
}

GET/v0/net/port/list

Returns the list of well-known and commonly used network ports with their service names, protocols, and descriptions.

Example Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.isvalid.dev/v0/net/port/list"

Object Fields

Field	Type	Description
port	number	Port number
serviceName	string	Service name
protocol	string	Transport protocol
description	string	Service description

Example Response

[
  { "port": 22, "serviceName": "SSH", "protocol": "TCP", "description": "Secure Shell" },
  { "port": 80, "serviceName": "HTTP", "protocol": "TCP", "description": "Hypertext Transfer Protocol" },
  { "port": 443, "serviceName": "HTTPS", "protocol": "TCP", "description": "HTTP over TLS/SSL" },
  ...
]