List observed subdomains - Infrawatch

List observed subdomains

curl --request GET \
  --url https://api.infrawatch.com/api/v1/search/dns/subdomains \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.infrawatch.com/api/v1/search/dns/subdomains', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.infrawatch.com/api/v1/search/dns/subdomains"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "domain": "example.com",
  "pagination": {
    "has_more": false,
    "limit": 50,
    "offset": 0,
    "total": 1,
    "total_relation": "eq"
  },
  "subdomains": [
    "api.example.com"
  ]
}

GET

https://api.infrawatch.com/api/v1

/

search

/

dns

/

subdomains

List observed subdomains

curl --request GET \
  --url https://api.infrawatch.com/api/v1/search/dns/subdomains \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.infrawatch.com/api/v1/search/dns/subdomains', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.infrawatch.com/api/v1/search/dns/subdomains"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "domain": "example.com",
  "pagination": {
    "has_more": false,
    "limit": 50,
    "offset": 0,
    "total": 1,
    "total_relation": "eq"
  },
  "subdomains": [
    "api.example.com"
  ]
}

Authorizations

X-API-Key

string

header

required

Infrawatch API key. Supply the complete key directly as the header value.

Query Parameters

domain

string

required

Domain whose strict descendants should be returned. A trailing dot and Unicode labels are canonicalized; public suffixes, IP addresses, URLs, and wildcards are rejected.

Required string length: 3 - 253

limit

integer

default:50

Page size.

Required range: 1 <= x <= 200

cursor

string

Opaque continuation token that expires 15 minutes after the first page and is bound to the dataset, normalized query, and resolved visibility context. Cannot be combined with offset. If it is invalid or expired, restart pagination without a cursor. Clients must not parse or persist it as a durable bookmark.

Required string length: 1 - 4096

Response

A bounded page of distinct observed subdomains.

domain

string<hostname>

required

Canonical parent domain used for the lookup.

Required string length: 1 - 253

pagination

object

required

Show child attributes

subdomains

string[]

required

Maximum array length: 200

Canonical DNS owner name strictly below the requested domain. DNS owner labels such as _acme-challenge and a leading wildcard are supported.

Required string length: 1 - 253