How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Cisco XDR Query API

This set of routes allow to query for records related to observable events.Results are returned in OCSF format.

Cisco XDR Query API is one of 83 APIs that Cisco XDR publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Query, Security, XDR, and Threat Detection. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 2 operations across 2 paths, and defines 28 schemas. It is described by OpenAPI 3.2.0, at version 1.0.107.

Requests are made against a single base URL, https://visibility.amp.cisco.com/.

2 operations 2 paths 28 schemas 2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.107
Base URL
https://visibility.amp.cisco.com
Authentication
API Key, API Key, OAuth 2.0
Resource Areas
1

Authentication & Security 3

Cisco XDR Query API declares 3 security schemes for authenticating requests. An API key is passed in the header as authorization (iroh). An API key is passed in the header as authorization (AuthorizationHeader). It supports OAuth 2.0 (oauth2) using the authorizationCode flow, exposing 25 scopes. By default, every request must be authenticated.

  • AuthorizationHeader — Ex: Bearer \

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 2 POST. Each is listed below with its method, path, parameters, and response codes.

Query 2

This set of routes allow to query for records related to observable events.Results are returned in OCSF format.

POST
/iroh/iroh-enrich/query/ocsf-sync
Get OCSF event data
3 params body → 200401500
POST
/iroh/iroh-enrich/query/ocsf
Retrieve OCSF event data asynchronously
3 params body → 200

Schemas 28

The contract defines 28 schemas that model the data the API accepts and returns. The most detailed are EnvelopedQueryOcsfBundleDataEvents (61 properties), OCSFQuery (9 properties), EnvelopedQueryOcsfBundleData (8 properties), ErrorMessage (7 properties). Each schema is shown below with its type and property counts.

EnvelopedQueryOcsfBundleDataEventsObservables
object
EnvelopedQueryOcsfBundleDataEventsProcess
object
The process object.
EnvelopedQueryOcsfBundleDataEventsApi
object
Describes details about a typical API (Application Programming Interface) call.
EnvelopedQueryOcsfBundleDataEventsUnmapped
object
The attributes that are not mapped to the event schema. The names and values of those attributes are specific to the event source.
EnvelopedQueryOcsfBundleDataEventsCisCsc
object
OCSFQuery
object
9 properties 4 required
EnvelopedQueryOcsfBundleDataEventsMalware
object
EnvelopedQueryOcsfBundleDataEventsActivities
object
Activities
ErrorMessage
object
7 properties 5 required
EnvelopedQueryOCSFBundle
object
2 properties
EnvelopedQueryOcsfBundleDataEventsCloud
object
Describes details about the Cloud environment where the event was originally created or logged.
EnvelopedQueryOcsfBundleDataEventsResources
object
EnvelopedQueryOcsfBundleDataEventsMetadata
object
The metadata associated with the event.
EnvelopedQueryOcsfBundleDataEventsDevice
object
An addressable device, computer system or host.
EnvelopedQueryOcsfBundleData
object
8 properties 7 required
EnvelopedQueryOcsfBundleDataEvents
object
Security Finding events describe findings, detections, anomalies, alerts and/or actions performed by security products
61 properties 10 required
EnvelopedQueryOcsfBundleDataEventsActor
object
The actor object describes details about the user/role/process that was the source of the activity.
EnvelopedQueryOcsfBundleDataEventsFinding
object
Finding object provides details related to a finding generated by security tool
EnvelopedQueryOcsfBundleDataEventsDispositions
object
EnvelopedQueryOcsfBundleDataEventsKillChain
object
NormalizedError-401
object
6 properties
Response8148706
object
4 properties 1 required
EnvelopedQueryOcsfBundleDataEventsAnalytic
object
The analytic technique used to create the finding or detection
EnvelopedQueryOcsfBundleDataEventsVulnerabilities
object
NormalizedError-500
object
6 properties
EnvelopedQueryOcsfBundleDataEventsAttacks
object
EnvelopedQueryOcsfBundleDataEventsCompliance
object
The compliance object provides context to compliance findings (e.g., a check against a specific regulatory or best practice framework such as CIS or NIST) and…
EnvelopedQueryOcsfBundleDataEventsEnrichments
object

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

cisco-xdr-query-api-openapi.yml Raw ↑

Other APIs Cisco XDR publishes across the network.

Cisco XDR Actor API
Cisco XDR Asset API
Cisco XDR Asset Mapping API
Cisco XDR Asset Properties API
Cisco XDR Attack Pattern API
Cisco XDR Bulk API
Cisco XDR Bundle API
Cisco XDR Campaign API
Cisco XDR Casebook API
Cisco XDR COA API
Cisco XDR Deliberate API
Cisco XDR Event API
Where this information came from

This is an independent, third-party profile of Cisco XDR Query API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.