> For the complete documentation index, see [llms.txt](https://docs.ox.security/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ox.security/api-documentation/api-reference/api--response-center/queries/get-incidents.md). # getIncidents Get a paginated list of incidents with filters. ### Examples {% tabs %} {% tab title="GraphQL" %} ```graphql query GetIncidents($input: GetIncidentsInput) { getIncidents(input: $input) { items { id caseId name description type severity status classification { attackType campaignName primaryImpact secondaryImpacts impactTargets capabilities executionTriggers evidence { attackType campaignName primaryImpact secondaryImpacts impactTargets capabilities executionTriggers } metadataContractVersion } scope exploitationStatus exploitationSource blockedReason owner creator slaTargetAt settings { allowManualClosure autoCloseWhenResolved cleanDaysBeforeClose autoReopenOnNewHit watchWindowDays } isOxDeclared publishType publishTypeReason autoExpandFromSource externalReferences sourceCreatedAt kevDiscoveredAt pinPosture { affectedEvaluated affectedUnpinned safeEvaluated safeUnpinned } oxPublishedAt counts { affectedApps affectedRepos affectedImages openFindings resolvedFindings removedFindings sbomMatches removedSbomMatches pipelineHits devEnvironments clearedMatches blockedItems blockedPipelineHits expiredPipelineHits blockedDevEnvironments expiredDevEnvironments excludedFindings suppressedSbomMatches cloudAccounts cloudRunningImages cloudRunningThisVersionImages openFindingsBySeverity { appoxalypse critical high medium low } } exposureState currentSeverity isMonitoring affectedResourceCount summary { title bullets lines { segments { text emphasis } } } aiSummary { bullets generatedAt model } indicatorCounts { cve package packageRange image issue advisorySource } lastRunDelta { newCount resolvedCount removedCount issues { newCount resolvedCount removedCount } sboms { newCount resolvedCount removedCount } } countsAsOf lastMatchedAt lastExposureChange assessmentComplete incompleteSources resolvedAt createdAt updatedAt indicators { osvAffectedVersions osvAffectedRanges { type events { introduced fixed last_affected limit } } id incidentId kind value versionRange fixedVersions remediationStatus remediations { action versions source vendor product packageName collectionUrl versionType affectedRange } isCompromised isCompromisedBasis infectsOnInstall ecosystem severity cvssScore cvssVersion epssScore epssPercentile epssDate epssCheckedAt cveIntelligence { exploitationStatus exploitationSource hasPublicExploit publicExploitLink firstReportedExploitationAt firstObservedExploitationAt kev { status checkedAt catalogFetchedAt catalogVersion dateReleased dateAdded dueDate requiredAction knownRansomwareCampaignUse } euKev { status checkedAt catalogFetchedAt source sourceDisplayName cve euvdId dateReported originSource exploitationTypes threatActors notes } articleEvidence { sourceUrl sourcePublishedAt analyzedAt analysisVersion articleTypes classificationConfidence claims { claimType reportingRelationship attributedSource explicitlyObservedAt evidenceExcerpt confidence } } vulnCheck { status dateAdded sourceUpdatedAt sensorObserved } } cweMetadata { status cwes provenance { source cwes } vulnerabilityClass vulnerabilityClassSource mappingVersion resolvedAt } addedAt source addedBy status url lastFetchedAt autoExpand matchState activeMatchCount isUnpinned aiExploitSimulation { status catalogVersion catalogGeneratedAt coverage { language packageName logic conditions { ruleId condition missingEvidence negated } docs } } } } totalCount totalUnfilteredCount hasMore } } ``` #### Variables This is an example input showing all available input fields. Only fields marked as required in the schema are mandatory. ```json { "input": { "search": "example", "statuses": ["Open"], "severities": ["Low"], "types": ["MaliciousLibrary"], "owners": ["example"], "isOxDeclared": true, "createdFrom": "example", "createdTo": "example", "conditionalFilters": [ { "fieldName": "example", "values": ["example"], "condition": "OR" } ], "sortBy": "updatedAt", "sortOrder": "asc", "limit": 100, "offset": 0 } } ``` {% endtab %} {% tab title="cURL" %} ```shell curl -X POST \ https://api.cloud.ox.security/api/apollo-gateway \ -H 'Content-Type: application/json' \ -H 'Authorization: YOUR_API_TOKEN' \ -d '{ "query": "query GetIncidents($input: GetIncidentsInput) { getIncidents(input: $input) { items { id caseId name description type severity status classification { attackType campaignName primaryImpact secondaryImpacts impactTargets capabilities executionTriggers evidence { attackType campaignName primaryImpact secondaryImpacts impactTargets capabilities executionTriggers } metadataContractVersion } scope exploitationStatus exploitationSource blockedReason owner creator slaTargetAt settings { allowManualClosure autoCloseWhenResolved cleanDaysBeforeClose autoReopenOnNewHit watchWindowDays } isOxDeclared publishType publishTypeReason autoExpandFromSource externalReferences sourceCreatedAt kevDiscoveredAt pinPosture { affectedEvaluated affectedUnpinned safeEvaluated safeUnpinned } oxPublishedAt counts { affectedApps affectedRepos affectedImages openFindings resolvedFindings removedFindings sbomMatches removedSbomMatches pipelineHits devEnvironments clearedMatches blockedItems blockedPipelineHits expiredPipelineHits blockedDevEnvironments expiredDevEnvironments excludedFindings suppressedSbomMatches cloudAccounts cloudRunningImages cloudRunningThisVersionImages openFindingsBySeverity { appoxalypse critical high medium low } } exposureState currentSeverity isMonitoring affectedResourceCount summary { title bullets lines { segments { text emphasis } } } aiSummary { bullets generatedAt model } indicatorCounts { cve package packageRange image issue advisorySource } lastRunDelta { newCount resolvedCount removedCount issues { newCount resolvedCount removedCount } sboms { newCount resolvedCount removedCount } } countsAsOf lastMatchedAt lastExposureChange assessmentComplete incompleteSources resolvedAt createdAt updatedAt indicators { osvAffectedVersions osvAffectedRanges { type events { introduced fixed last_affected limit } } id incidentId kind value versionRange fixedVersions remediationStatus remediations { action versions source vendor product packageName collectionUrl versionType affectedRange } isCompromised isCompromisedBasis infectsOnInstall ecosystem severity cvssScore cvssVersion epssScore epssPercentile epssDate epssCheckedAt cveIntelligence { exploitationStatus exploitationSource hasPublicExploit publicExploitLink firstReportedExploitationAt firstObservedExploitationAt kev { status checkedAt catalogFetchedAt catalogVersion dateReleased dateAdded dueDate requiredAction knownRansomwareCampaignUse } euKev { status checkedAt catalogFetchedAt source sourceDisplayName cve euvdId dateReported originSource exploitationTypes threatActors notes } articleEvidence { sourceUrl sourcePublishedAt analyzedAt analysisVersion articleTypes classificationConfidence claims { claimType reportingRelationship attributedSource explicitlyObservedAt evidenceExcerpt confidence } } vulnCheck { status dateAdded sourceUpdatedAt sensorObserved } } cweMetadata { status cwes provenance { source cwes } vulnerabilityClass vulnerabilityClassSource mappingVersion resolvedAt } addedAt source addedBy status url lastFetchedAt autoExpand matchState activeMatchCount isUnpinned aiExploitSimulation { status catalogVersion catalogGeneratedAt coverage { language packageName logic conditions { ruleId condition missingEvidence negated } docs } } } } totalCount totalUnfilteredCount hasMore } }", "variables": { "input": { "search": "example", "statuses": ["Open"], "severities": ["Low"], "types": ["MaliciousLibrary"], "owners": ["example"], "isOxDeclared": true, "createdFrom": "example", "createdTo": "example", "conditionalFilters": [ { "fieldName": "example", "values": ["example"], "condition": "OR" } ], "sortBy": "updatedAt", "sortOrder": "asc", "limit": 100, "offset": 0 } } }' ``` {% endtab %} {% tab title="Node.js" %} ```javascript const query = 'query GetIncidents($input: GetIncidentsInput) { getIncidents(input: $input) { items { id caseId name description type severity status classification { attackType campaignName primaryImpact secondaryImpacts impactTargets capabilities executionTriggers evidence { attackType campaignName primaryImpact secondaryImpacts impactTargets capabilities executionTriggers } metadataContractVersion } scope exploitationStatus exploitationSource blockedReason owner creator slaTargetAt settings { allowManualClosure autoCloseWhenResolved cleanDaysBeforeClose autoReopenOnNewHit watchWindowDays } isOxDeclared publishType publishTypeReason autoExpandFromSource externalReferences sourceCreatedAt kevDiscoveredAt pinPosture { affectedEvaluated affectedUnpinned safeEvaluated safeUnpinned } oxPublishedAt counts { affectedApps affectedRepos affectedImages openFindings resolvedFindings removedFindings sbomMatches removedSbomMatches pipelineHits devEnvironments clearedMatches blockedItems blockedPipelineHits expiredPipelineHits blockedDevEnvironments expiredDevEnvironments excludedFindings suppressedSbomMatches cloudAccounts cloudRunningImages cloudRunningThisVersionImages openFindingsBySeverity { appoxalypse critical high medium low } } exposureState currentSeverity isMonitoring affectedResourceCount summary { title bullets lines { segments { text emphasis } } } aiSummary { bullets generatedAt model } indicatorCounts { cve package packageRange image issue advisorySource } lastRunDelta { newCount resolvedCount removedCount issues { newCount resolvedCount removedCount } sboms { newCount resolvedCount removedCount } } countsAsOf lastMatchedAt lastExposureChange assessmentComplete incompleteSources resolvedAt createdAt updatedAt indicators { osvAffectedVersions osvAffectedRanges { type events { introduced fixed last_affected limit } } id incidentId kind value versionRange fixedVersions remediationStatus remediations { action versions source vendor product packageName collectionUrl versionType affectedRange } isCompromised isCompromisedBasis infectsOnInstall ecosystem severity cvssScore cvssVersion epssScore epssPercentile epssDate epssCheckedAt cveIntelligence { exploitationStatus exploitationSource hasPublicExploit publicExploitLink firstReportedExploitationAt firstObservedExploitationAt kev { status checkedAt catalogFetchedAt catalogVersion dateReleased dateAdded dueDate requiredAction knownRansomwareCampaignUse } euKev { status checkedAt catalogFetchedAt source sourceDisplayName cve euvdId dateReported originSource exploitationTypes threatActors notes } articleEvidence { sourceUrl sourcePublishedAt analyzedAt analysisVersion articleTypes classificationConfidence claims { claimType reportingRelationship attributedSource explicitlyObservedAt evidenceExcerpt confidence } } vulnCheck { status dateAdded sourceUpdatedAt sensorObserved } } cweMetadata { status cwes provenance { source cwes } vulnerabilityClass vulnerabilityClassSource mappingVersion resolvedAt } addedAt source addedBy status url lastFetchedAt autoExpand matchState activeMatchCount isUnpinned aiExploitSimulation { status catalogVersion catalogGeneratedAt coverage { language packageName logic conditions { ruleId condition missingEvidence negated } docs } } } } totalCount totalUnfilteredCount hasMore } }'; fetch("https://api.cloud.ox.security/api/apollo-gateway", { method: "POST", headers: { "Content-Type": "application/json", "Authorization": "YOUR_API_TOKEN" }, body: JSON.stringify({ query: query, // This is an example input showing all available input fields. Only fields marked as required in the schema are mandatory. variables: { input: { search: "example", statuses: ["Open"], severities: ["Low"], types: ["MaliciousLibrary"], owners: ["example"], isOxDeclared: true, createdFrom: "example", createdTo: "example", conditionalFilters: [ { fieldName: "example", values: ["example"], condition: "OR" } ], sortBy: "updatedAt", sortOrder: "asc", limit: 100, offset: 0 } } }) }) .then(response => response.json()) .then(result => console.log(JSON.stringify(result, null, 2))) .catch(error => console.error('Error:', error)); ``` {% endtab %} {% tab title="Python" %} ```python import requests query = 'query GetIncidents($input: GetIncidentsInput) { getIncidents(input: $input) { items { id caseId name description type severity status classification { attackType campaignName primaryImpact secondaryImpacts impactTargets capabilities executionTriggers evidence { attackType campaignName primaryImpact secondaryImpacts impactTargets capabilities executionTriggers } metadataContractVersion } scope exploitationStatus exploitationSource blockedReason owner creator slaTargetAt settings { allowManualClosure autoCloseWhenResolved cleanDaysBeforeClose autoReopenOnNewHit watchWindowDays } isOxDeclared publishType publishTypeReason autoExpandFromSource externalReferences sourceCreatedAt kevDiscoveredAt pinPosture { affectedEvaluated affectedUnpinned safeEvaluated safeUnpinned } oxPublishedAt counts { affectedApps affectedRepos affectedImages openFindings resolvedFindings removedFindings sbomMatches removedSbomMatches pipelineHits devEnvironments clearedMatches blockedItems blockedPipelineHits expiredPipelineHits blockedDevEnvironments expiredDevEnvironments excludedFindings suppressedSbomMatches cloudAccounts cloudRunningImages cloudRunningThisVersionImages openFindingsBySeverity { appoxalypse critical high medium low } } exposureState currentSeverity isMonitoring affectedResourceCount summary { title bullets lines { segments { text emphasis } } } aiSummary { bullets generatedAt model } indicatorCounts { cve package packageRange image issue advisorySource } lastRunDelta { newCount resolvedCount removedCount issues { newCount resolvedCount removedCount } sboms { newCount resolvedCount removedCount } } countsAsOf lastMatchedAt lastExposureChange assessmentComplete incompleteSources resolvedAt createdAt updatedAt indicators { osvAffectedVersions osvAffectedRanges { type events { introduced fixed last_affected limit } } id incidentId kind value versionRange fixedVersions remediationStatus remediations { action versions source vendor product packageName collectionUrl versionType affectedRange } isCompromised isCompromisedBasis infectsOnInstall ecosystem severity cvssScore cvssVersion epssScore epssPercentile epssDate epssCheckedAt cveIntelligence { exploitationStatus exploitationSource hasPublicExploit publicExploitLink firstReportedExploitationAt firstObservedExploitationAt kev { status checkedAt catalogFetchedAt catalogVersion dateReleased dateAdded dueDate requiredAction knownRansomwareCampaignUse } euKev { status checkedAt catalogFetchedAt source sourceDisplayName cve euvdId dateReported originSource exploitationTypes threatActors notes } articleEvidence { sourceUrl sourcePublishedAt analyzedAt analysisVersion articleTypes classificationConfidence claims { claimType reportingRelationship attributedSource explicitlyObservedAt evidenceExcerpt confidence } } vulnCheck { status dateAdded sourceUpdatedAt sensorObserved } } cweMetadata { status cwes provenance { source cwes } vulnerabilityClass vulnerabilityClassSource mappingVersion resolvedAt } addedAt source addedBy status url lastFetchedAt autoExpand matchState activeMatchCount isUnpinned aiExploitSimulation { status catalogVersion catalogGeneratedAt coverage { language packageName logic conditions { ruleId condition missingEvidence negated } docs } } } } totalCount totalUnfilteredCount hasMore } }' response = requests.post( "https://api.cloud.ox.security/api/apollo-gateway", headers={ "Content-Type": "application/json", "Authorization": "YOUR_API_TOKEN" }, json={ "query": query, # This is an example input showing all available input fields. Only fields marked as required in the schema are mandatory. "variables": { "input": { "search": "example", "statuses": ["Open"], "severities": ["Low"], "types": ["MaliciousLibrary"], "owners": ["example"], "isOxDeclared": true, "createdFrom": "example", "createdTo": "example", "conditionalFilters": [ { "fieldName": "example", "values": ["example"], "condition": "OR" } ], "sortBy": "updatedAt", "sortOrder": "asc", "limit": 100, "offset": 0 } } } ) if response.status_code == 200: result = response.json() print(result) else: print(f"Error: {response.status_code}") print(response.text) ``` {% endtab %} {% endtabs %} ### Arguments You can use the following argument(s) to customize your `getIncidents` query. | Argument | Description | Supported fields | | ---------------------------------------------------------------------------------------------------------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | input [`GetIncidentsInput`](/api-documentation/api-reference/api--response-center/types/inputs/get-incidents-input.md) | |

search String
statuses \[IncidentStatus!]
severities \[IncidentSeverity!]
types \[IncidentType!]
owners \[String!]
isOxDeclared Boolean
createdFrom DateTime
createdTo DateTime
conditionalFilters \[IncidentConditionalFilterInput!]
sortBy IncidentSortField
sortOrder SortOrder
limit Int
offset Int

| ### Fields Return type: [`IncidentsConnection!`](/api-documentation/api-reference/api--response-center/types/objects/incidents-connection.md) You can use the following field(s) to specify what information your `getIncidents` query will return. Please note that some fields may have their own subfields. | Field | Description | Supported fields | | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | items [`[Incident!]!`](/api-documentation/api-reference/api--response-center/types/objects/incident.md) | |

id String!
caseId String!
name String!
description String
type IncidentType!
severity IncidentSeverity!
status IncidentStatus!
classification IncidentClassification
scope IncidentScope
exploitationStatus CveExploitationStatus
exploitationSource CveExploitationSource
blockedReason String
owner String
creator String!
slaTargetAt DateTime
settings IncidentSettings!
isOxDeclared Boolean!
publishType IncidentPublishType!
publishTypeReason String
autoExpandFromSource Boolean!
externalReferences \[String!]!
sourcePublishedAt DateTime ⚠️
sourceCreatedAt DateTime
kevDiscoveredAt DateTime
pinPosture IncidentPinPosture
oxPublishedAt DateTime
counts IncidentCounts!
exposureState ExposureState
currentSeverity IncidentSeverity
isMonitoring Boolean!
affectedResourceCount Int!
summary \[IncidentSummarySection!]!
aiSummary IncidentAiSummary
indicatorCounts IncidentIndicatorCounts
lastRunDelta IncidentLastRunDelta
countsAsOf DateTime
lastMatchedAt DateTime
lastExposureChange DateTime
assessmentComplete Boolean
incompleteSources \[String!]
resolvedAt DateTime
createdAt DateTime
updatedAt DateTime
indicators \[Indicator!]

| | totalCount `Int!` | | | | totalUnfilteredCount `Int!` | Counts the incidents in the organization that the incident list can show, ignoring the search and filters of the request. | | | hasMore `Boolean!` | | | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.ox.security/api-documentation/api-reference/api--response-center/queries/get-incidents.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.