Scan a target's open ports, in one call.

Pass a target. Get back the open ports detected, the service banners observed, and basic protocol fingerprinting. Useful for service-exposure validation and ASM workflows.

WHAT THIS API RETURNS

Service-exposure detection, against a single target.

The Port Scan API runs an on-demand scan against a target host and returns the open ports detected along with the service banners observed and basic protocol fingerprinting. The scan operates from Deepinfo's distributed probe network.

Pass the target as a domain or IP. Use timeout to bound how long the scan runs; use proxy to route the probe through a different region.

This API is the right input for ASM verification, vendor-exposure validation, and any workflow that needs to confirm what services a target is currently exposing.

REQUEST

POST a target, get an open-port report back.

Endpoint:

POST https://api.deepinfo.com/v1/lookup/port-scan

Request body is a JSON object with the parameters below.

Body parameters:

Name In Type Required Description
target body string Yes A domain or IP such as deepinfo.com or 203.0.113.42.
timeout body integer No Maximum scan duration in seconds. Defaults to a per-endpoint sensible value; see docs.
proxy body string No Optional proxy region or routing hint.

Authentication is by API token in the request header. See docs.deepinfo.com for the full request reference.

SAMPLE RESPONSE

See what the API returns.

Real response structure for the Scan a target's open ports, in one call endpoint. Field coverage may vary based on query parameters and data availability.

JSON RESPONSE
{
  "target": "deepinfo.com",
  "resolved_ip": "203.0.113.42",
  "check_date": "2026-05-02T08:30:11Z",
  "open_ports": [
    {"port": 22,  "protocol": "tcp", "service": "ssh",   "banner": "SSH-2.0-OpenSSH_8.2p1 Ubuntu-4ubuntu0.5"},
    {"port": 80,  "protocol": "tcp", "service": "http",  "banner": "HTTP/1.1 301 Moved Permanently
Server: nginx"},
    {"port": 443, "protocol": "tcp", "service": "https", "banner": "TLS 1.3, ECDHE-RSA-AES256-GCM-SHA384"}
  ],
  "scan_status": "complete"
}
STRUCTURED VIEW
Fields
Target
deepinfo.com
Resolved ip
203.0.113.42
Check date
2026-05-02T08:30:11Z
Scan status
complete
Open ports
Count
3
First port
22
First protocol
tcp
First service
ssh
First banner
SSH-2.0-OpenSSH_8.2p1 Ubuntu-4ubuntu0.5

Sample response shown. Real responses depend on query parameters, data availability, and API version. Talk to us for full schema documentation.

“On-demand port scans in our exposure-validation workflow give us the live state our customers expect during ASM reviews. Service banners and protocol fingerprinting in the same call cut the validation step we used to do separately.”

— Security Engineer, Attack Surface Management Vendor
GET STARTED

Run a sample scan, or schedule continuous validation.

We'll set up token access and answer schema questions on a call.

Talk to us Browse API docs