Added

Attack surface services

Attack Surface API — Services list

A new endpoint is available to list the network services (open ports) detected on your external targets: the same data as the Attack Surface CSV export. Each result is one service, with a summary of the target it runs on.

Endpoint: GET /v1/attack-surface/services/

Each service includes its port and protocol, the detected service, product and version, the web page title, TLS/SSL certificate expiry, web application firewall details, and when it was first and last observed. The target summary includes its address, IP address, hostnames, status and when it was last scanned. Results are ordered by target address, port and protocol, and pagination works the same as other list endpoints. Services are limited to the ports included in your plan. Targets without open ports aren't included.

  • target_ids (optional) — Comma-separated target IDs.
  • target_addresses (optional) — Comma-separated target addresses (case-insensitive, partial match).
  • ip_addresses (optional) — Comma-separated target IP addresses.
  • tag_names (optional) — Comma-separated tag names.
  • target_status (optional) — Target status, e.g. live or unresponsive.
  • ports (optional) — Comma-separated ports.
  • protocols (optional) — One or both of tcp and udp.
  • service_names (optional) — Comma-separated service names, e.g. https, ssh.
  • products (optional) — Comma-separated products, e.g. nginx.
  • ssl_cert_expiry (optional) — One or both of expired and expiring (expires within the next 30 days).
  • search (optional) — Case-insensitive search across target address, port, service and product.

For more information, see the API documentation for attack surface services.