Get Asset Details

Cortex Xpanse REST API

post /public_api/v1/assets/get_asset_internet_exposure/

Get asset details according to the asset ID. You can send up to 20 IDs.
Required license: Cortex Xpanse Expander

Request headers
authorization
String
required
api-key
Example: {{api_key}}
x-xdr-auth-id
String
required
api-key-id
Example: {{api_key_id}}
Body parameters
required
request_dataObjectrequired

(Required) A dictionary containing the API request fields. An empty dictionary returns all results.

asm_id_listArray[string]

A list of string(s) representing the asset IDs.

REQUEST BODY
{ "request_data": { "asm_id_list": [ "asm_id_list", "asm_id_list" ] } }
CURL
curl -X 'POST'
-H 'Accept: application/json'
-H 'Content-Type: application/json'
-H 'authorization: {{api_key}}' -H 'x-xdr-auth-id: {{api_key_id}}'
'https://api-}/public_api/v1/assets/get_asset_internet_exposure/'
-d '{ "request_data" : { "asm_id_list" : [ "asm_id_list", "asm_id_list" ] } }'
Responses

OK

Body
replyObject
detailsArray
asm_idsString
nameString
typeString
last_observedInteger
first_observedInteger
externally_detected_providersArray[string]
createdInteger
ipsArray[None]
active_service_idsArray[string]
all_service_idsArray[string]
active_external_services_typesArray[string]
domainString
certificate_issuerString
certificate_algorithmString
certificate_classificationsArray[string]
resolvesBoolean
detailsObject
external_servicesArray
serviceTypeString
serviceKeyString
activityStatusString
externally_inferred_vulnerability_scoreNumber
externally_inferred_cvesArray[string]
explainersArray[string]
tagsArray[string]
ipv6sArray[string]
has_bu_overridesBoolean
RESPONSE
{ "reply": { "details": [ { "asm_ids": "asm_ids_example", "name": "name_example", "type": "type_example", "last_observed": 0, "first_observed": 0, "externally_detected_providers": [ "externally_detected_providers_example" ], "created": 0, "ips": [ {} ], "active_service_ids": [ "active_service_ids_example" ], "all_service_ids": [ "all_service_ids_example" ], "active_external_services_types": [ "active_external_services_types_example" ], "domain": "domain_example", "certificate_issuer": "certificate_issuer_example", "certificate_algorithm": "certificate_algorithm_example", "certificate_classifications": [ "certificate_classifications_example" ], "resolves": false, "details": {}, "external_services": [ { "serviceType": "serviceType_example", "serviceKey": "serviceKey_example", "activityStatus": "activityStatus_example" } ], "externally_inferred_vulnerability_score": 0.0, "externally_inferred_cves": [ "externally_inferred_cves_example" ], "explainers": [ "explainers_example" ], "tags": [ "tags_example" ], "ipv6s": [ "ipv6s_example" ], "has_bu_overrides": false } ] } }

Bad Request. Got an invalid JSON.

Body
replyObject

The query results upon error.

RESPONSE
{ "reply": {} }

Unauthorized access. An issue occurred during authentication. This can indicate an incorrect key, id, or other invalid authentication parameters.

Body
replyObject

The query results upon error.

RESPONSE
{ "reply": {} }

Unauthorized access. User does not have the required license type to run this API.

Body
replyObject

The query results upon error.

RESPONSE
{ "reply": {} }

Forbidden access. The provided API Key does not have the required RBAC permissions to run this API.

Body
replyObject

The query results upon error.

RESPONSE
{ "reply": {} }

Unprocessable Entity

Body
codeInteger

Error code

statusString

Error name

messageString

Error message

errorsObject

Errors

RESPONSE
{ "code": 0, "status": "status_example", "message": "message_example", "errors": {} }

Internal server error. A unified status for API communication type errors.

Body
replyObject

The query results upon error.

RESPONSE
{ "reply": {} }