vendors

List vendor domains

Returns a list of domains for a vendor.

Required API key permissions: VendorRisk (select when creating API key in Account Settings)

get/vendor/domains

Request

Query parameters

vendor_primary_hostnamestring required

The primary hostname of the vendor to show domains for.

activeboolean

Retrieve active domains

inactiveboolean

Retrieve inactive domains

labelsstring[]

Filter result by the provided labels

page_tokenstring

The page_token from a previous request, use this to get the next page of results.

page_sizeinteger

The number of results to return per page.

sort_by'domain' | 'active' | 'automated_score' | 'scanned_at'

The value to sort the domains by

If not specified will default to domain and set sort_desc to true

sort_descboolean

Whether or not to sort the results in descending order

Response

A list of domains

next_page_tokenstring

The token to be used to retrieve the next page of results. Will not be returned if there are no more results.

total_resultsinteger

The total number of domains found.

Changes

No recorded changes to this operation across all 2 revisions of this API.