---
title: "List Subdomains"
method: GET
path: "/domains/{domain_id}/subdomains"
---

# List Subdomains

`GET /domains/{domain_id}/subdomains`

## Request

- Base URL: `https://app.aikido.dev/api/public/v1`
- URL: `https://app.aikido.dev/api/public/v1/domains/{domain_id}/subdomains`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://app.aikido.io/api/oauth/token` scopes: `domains:read`

List all the subdomains for a attack surface domain

## Path parameters

- `domain_id` integer, required

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

A list of subdomains for the domain

- object[]
  - `id` string, required: The uuid of the subdomain
  - `name` string, required: The name of the subdomain
  - `ip_addresses` unknown[], required: The IP addresses of the subdomain
    - unknown
  - `open_ports` object[], required: The open ports of the subdomain
    - `port` integer, required: The port number
    - `protocol` string, required: The protocol of the port
    - `service` string, required: The service of the port
  - `is_responsive` boolean, required: Whether the subdomain is responsive to pings or network connectivity tests
  - `is_excluded` boolean, required: Whether the subdomain is excluded from the attack surface scan
  - `dns_last_resolved_at` integer, required: The timestamp of when the DNS last resolved for the subdomain

---

[API](https://skmtc.dev/aikido/apis/aikido-security-api-documentation.md) - [All operations](https://skmtc.dev/aikido/apis/aikido-security-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/aikido/apis/aikido-security-api-documentation/revisions/da8691338133?raw)