v1

latestOpenAPI 3.1.02026-07-261690320.7 KB

List Subdomains

List all the subdomains for a attack surface domain

get/domains/{domain_id}/subdomains

Path parameters

domain_idinteger required

The ID of the domain to list the subdomains for

Query parameters

pageinteger

The page number (zero-indexed). Page through the results until fewer than per_page subdomains are returned.

per_pageinteger

The number of subdomains per page

Response

A list of subdomains for the domain

idstring required

The uuid of the subdomain

namestring required

The name of the subdomain

is_responsiveboolean required

Whether the subdomain is responsive to pings or network connectivity tests

is_excludedboolean required

Whether the subdomain is excluded from the attack surface scan

dns_last_resolved_atinteger required

The timestamp of when the DNS last resolved for the subdomain

Example response

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "app.aikido.dev",
    "ip_addresses": [
      "192.168.1.1",
      "192.168.1.2"
    ],
    "open_ports": [
      {
        "port": 80,
        "protocol": "http",
        "service": "http"
      },
      {
        "port": 443,
        "protocol": "http",
        "service": "https"
      }
    ],
    "is_responsive": true,
    "is_excluded": false,
    "dns_last_resolved_at": 1772704787
  },
  {
    "id": "123e4567-e89b-12d3-a456-426614174001",
    "name": "apidocs.aikido.dev",
    "ip_addresses": [
      "192.168.1.3",
      "192.168.1.4"
    ],
    "open_ports": [
      {
        "port": 80,
        "protocol": "http",
        "service": "http"
      },
      {
        "port": 443,
        "protocol": "https",
        "service": "https"
      }
    ],
    "is_responsive": true,
    "is_excluded": true,
    "dns_last_resolved_at": 1772704790
  }
]