post
/public_api/v1/assets/get_external_service
Required license: **Cortex Xpanse Expander**
Get service details according to the service ID. You can send up to 20 IDs.
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-yourfqdn/public_api/v1/assets/get_external_service" \
-d '{
"request_data" : {
"service_id_list" : [ "service_id_list", "service_id_list" ]
}
}'
Request headers
authorization
required
String
api-key
Example:
{api_key}
x-xdr-auth-id
required
String
api-key-id
Example:
{api_key_id}
Request
Body
optional
Example:
{"request_data":{"service_id_list":[""]}}
request_data
optional
(Required) A dictionary containing the API request fields.
service_id_list
optional
Array
of strings
Responses
OK
Body
reply
optional
JSON object containing the query result.
details
optional
Array
Service details according to the service ID.
service_id
optional
String
service_name
optional
String
service_type
optional
String
ip_address
optional
Array
of strings
domain
optional
Array
of objects
externally_detected_providers
optional
Array
of strings
is_active
optional
String
first_observed
optional
Integer
last_observed
optional
Integer
port
optional
Integer
protocol
optional
String
active_classifications
optional
Array
of strings
inactive_classifications
optional
Array
of objects
discovery_type
optional
String
business_units
optional
Array
of strings
externally_inferred_vulnerability_score
optional
Object
externally_inferred_cves
optional
Array
of objects
details
optional
serviceKey
optional
String
serviceKeyType
optional
String
businessUnits
optional
Array
name
optional
String
providerDetails
optional
Array
name
optional
String
firstObserved
optional
Integer
lastObserved
optional
Integer
certificates
optional
Array
certificate
optional
issuer
optional
String
issuerAlternativeNames
optional
String
issuerCountry
optional
String
issuerEmail
optional
Object
issuerLocality
optional
String
issuerName
optional
String
issuerOrg
optional
String
formattedIssuerOrg
optional
String
issuerOrgUnit
optional
String
issuerState
optional
String
publicKey
optional
String
publicKeyAlgorithm
optional
String
publicKeyRsaExponent
optional
Integer
signatureAlgorithm
optional
String
subject
optional
String
subjectAlternativeNames
optional
String
subjectCountry
optional
String
subjectEmail
optional
String
subjectLocality
optional
String
subjectName
optional
String
subjectOrg
optional
String
subjectOrgUnit
optional
String
subjectState
optional
String
serialNumber
optional
String
validNotBefore
optional
Integer
validNotAfter
optional
Integer
version
optional
String
publicKeyBits
optional
Integer
publicKeyModulus
optional
String
publicKeySpki
optional
String
sha1Fingerprint
optional
String
sha256Fingerprint
optional
String
md5Fingerprint
optional
String
activityStatus
optional
String
lastObserved
optional
Integer
firstObserved
optional
Integer
domains
optional
Array
of objects
ips
optional
Array
ip
optional
String
protocol
optional
String
provider
optional
String
geolocation
optional
latitude
optional
Number
longitude
optional
Number
countryCode
optional
String
city
optional
String
regionCode
optional
String
timeZone
optional
Object
activityStatus
optional
String
lastObserved
optional
Integer
firstObserved
optional
Integer
classifications
optional
Array
name
optional
String
activityStatus
optional
String
values
optional
Array
jsonValue
optional
String
firstObserved
optional
Integer
lastObserved
optional
Integer
firstObserved
optional
Integer
lastObserved
optional
Integer
tlsVersions
optional
Array
tlsVersion
optional
String
cipherSuite
optional
String
firstObserved
optional
Integer
lastObserved
optional
Integer
activityStatus
optional
String
inferredCvesObserved
optional
Array
of objects
enrichedObservationSource
optional
String
ip_ranges
optional
Object
Bad Request. Got an invalid JSON.
Body
The query result upon error.
err_code
optional
String
HTTP response code.
err_msg
optional
String
Error message.
err_extra
optional
String
Additional information describing the error.
Unauthorized access. An issue occurred during authentication. This can indicate an incorrect key, id, or other invalid authentication parameters.
Body
The query result upon error.
err_code
optional
String
HTTP response code.
err_msg
optional
String
Error message.
err_extra
optional
String
Additional information describing the error.
Unauthorized access. User does not have the required license type to run this API.
Body
The query result upon error.
err_code
optional
String
HTTP response code.
err_msg
optional
String
Error message.
err_extra
optional
String
Additional information describing the error.
Forbidden access. The provided API Key does not have the required RBAC permissions to run this API.
Body
The query result upon error.
err_code
optional
String
HTTP response code.
err_msg
optional
String
Error message.
err_extra
optional
String
Additional information describing the error.
Internal server error. A unified status for API communication type errors.
Body
The query result upon error.
err_code
optional
String
HTTP response code.
err_msg
optional
String
Error message.
err_extra
optional
String
Additional information describing the error.