chaos

Get Associated Domains

Changed on

Discover domains related to a given domain through acquisition history, certificate transparency logs, and WHOIS records. Returns associated domains with evidence of their relationship.

get/v1/domain/associated

Request

Query parameters

domainstring

Domain name to fetch associated domains. If omitted, returns associated domains for all your verified domains.

sourcestring

Comma-separated source filter (acquisition_history, certificate_history, whois_history)

activeboolean

Filter by liveness (true=alive, false=unreachable)

sort'active' | 'domain' | 'source' | 'subdomain_count' | 'update_date'

Sort results

limitinteger

Maximum results per page (pagination). If omitted, returns all.

pageinteger

Page number (pagination, starts at 1)

rawboolean

If true, returns plain text list (one domain per line)

Headers

X-Team-Idstring

Response

Associated domains response

domainstring required

Queried domain

sourcesstring[] required

List of sources used in the query

sources_countobject

Count of results per source

unique_countinteger

Unique associated domains count

limitinteger

Maximum results per page when paginated

pageinteger

Current page when paginated

total_countinteger

Total associated domains when paginated

total_pagesinteger

Total pages when paginated

Changes

    • warning

      removed the optional property /// from the response with the status

    • info

      api tag chaos added

    • info

      api tag enumerations removed

    • info

      added the new optional header request parameter X-Team-Id

    • info

      added the optional property /// to the response with the status

    • info

      endpoint added