Get a complete or filtered list of your public-facing websites.
Required License: Cortex Xpanse Expander
curl -X POST \
-H "Accept: application/json" \
-H "Content-Type: application/json" -H "authorization: authorization_example" -H "x-xdr-auth-id: xXdrAuthId_example" \
"https://api-yourfqdn/public_api/v1/assets/get_external_websites" \
-d '{
"request_data" : {
"search_from" : 0,
"next_page_token" : "next_page_token",
"filters" : [ {
"field" : "host",
"value" : [ "value", "value" ],
"operator" : "contains/not_contains"
}, {
"field" : "host",
"value" : [ "value", "value" ],
"operator" : "contains/not_contains"
} ],
"sort" : {
"field" : "http_type",
"keyword" : "ASC"
},
"search_to" : 6,
"use_page_token" : true
}
}'
authorization_example
xXdrAuthId_example
{"request_data":{"filters":[{"field":"host","operator":"contains/not_contains","value":"string"}],"search_from":0,"search_to":0,"sort":{"field":"http_type","keyword":"ASC"},"use_page_token":true,"next_page_token":"string"}}
A dictionary containing the API request fields.
An empty dictionary returns all results.
String that identifies the external service field the filter is matching. Filters are based on the following case-sensitive keywords:
- host
- is_active
- technology_ids
- provider_names
- site_categories
- active_service_ids
- ips
- tags
- http_type
- third_party_script_domains
- authentication
String that identifies the comparison operator you want to use for this filter. Valid operator keywords and corresponding filter fields are:
- contains/not_contains- used with
http_type,provider_names,site_categories - eq/ne - used with
host,authentication - in - used with
is_active,http_type,tags,active_service_ids,ips,third_party_script_domains,technology_ids
Value that the filter must match. The contents of this field will differ depending on the website field that you specified for this filter:
- host - string
- is_active - values are
yesorno - technology_ids - list of strings
- provider_names - string
- site_categories - string
- active_service_ids - list of strings
- ips - list of strings
- tags - list of strings
- http_type - values are
http_only,http_that_redirects_to_https,https_only - third_party_script_domains - list of strings
- authentication - string
An integer representing the start offset index of results
Default value - 0
An integer representing the start offset index of results. Use this field to specify the number of results on a page when using page token pagination.
Default value - 500
is_active and ASC.Valid values are:
http_typefirst_observedlast_observed
Valid values are:
- ASC - ascending order
- DESC - descending order ASC is the default.
"use_page_token":true in the initial request to paginate the response data.
Sort is not supported when using the use_page_token/next_page_token fields.
"use_page_token":true was included in the initial request, the response for that request will include a page token.
Use "next_page_token":"string" to pass that page token into the next request to paginate the next set of data.
OK
Bad Request. Got an invalid JSON.
Unauthorized access. An issue occurred during authentication. This can indicate an incorrect key, id, or other invalid authentication parameters.
Unauthorized access. User does not have the required license type to run this API.
Forbidden access. The provided API Key does not have the required RBAC permissions to run this API.
Internal server error. A unified status for API communication type errors.