devguard
Incidents

Get a list of paginated incidents.

GET
/incidents/

Authorization

Authorization
AuthorizationBearer <token>

In: header

Query Parameters

limit?number
Range5 <= value
Default100
page?number
Range1 <= value
Default1
organizationId*string
Length1 <= length
sortColumn?string
sortDirection?string

Value in

  • "asc"
  • "desc"
filterByName?string
filterByLabels?array<string>
filterByStatus?array<>
filterBySeverity?array<>
filterByArchived?string
Default"active"

Value in

  • "active"
  • "archived"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/incidents/?organizationId=string"
{  "items": [    {      "id": "string",      "shortId": -9007199254740991,      "slug": "string",      "name": "string",      "description": "string",      "ownerId": "string",      "status": "OPEN",      "severity": "LOW",      "threatClassId": "string",      "occurredAt": "string",      "detectedAt": "string",      "resolvedAt": "string",      "closedAt": "string",      "rootCause": "string",      "lessonsLearned": "string",      "isPersonalDataBreach": true,      "notificationDeadline": "string",      "authorityNotifiedAt": "string",      "dataSubjectsNotifiedAt": "string",      "notificationNotes": "string",      "createdAt": "string",      "updatedAt": "string",      "archivedAt": "string",      "organizationId": "string",      "owner": {        "id": "string",        "slug": "string",        "name": "string",        "description": "string",        "archivedAt": "string",        "organizationId": "string",        "users": [          "string"        ]      },      "threatClass": {        "id": "string",        "slug": "string",        "name": "string",        "description": "string",        "createdAt": "string",        "updatedAt": "string",        "archivedAt": "string",        "organizationId": "string"      },      "entries": [        {          "id": "string",          "incidentId": "string",          "occurredAt": "string",          "note": "string",          "authorId": "string",          "createdAt": "string",          "organizationId": "string"        }      ],      "treatmentLinks": [        {          "incidentId": "string",          "treatmentActionId": "string",          "organizationId": "string",          "linkedAt": "string",          "linkedBy": "string",          "treatmentAction": {            "id": "string",            "shortId": -9007199254740991,            "slug": "string",            "name": "string",            "description": "string",            "ownerId": "string",            "createdAt": "string",            "updatedAt": "string",            "organizationId": "string",            "archivedAt": "string",            "dueDate": "string",            "status": "UNKNOWN"          }        }      ],      "assetLinks": [        {          "incidentId": "string",          "assetId": "string",          "organizationId": "string",          "linkedAt": "string",          "linkedBy": "string",          "asset": {            "id": "string",            "shortId": -9007199254740991,            "slug": "string",            "name": "string",            "description": "string",            "ownerId": "string",            "createdAt": "string",            "updatedAt": "string",            "archivedAt": "string",            "organizationId": "string",            "status": "ACTIVE",            "parentId": "string",            "assetClassId": "string",            "locationId": "string",            "retentionPeriodId": "string",            "lastReviewId": "string",            "confidentialityRating": -9007199254740991,            "integrityRating": -9007199254740991,            "availabilityRating": -9007199254740991          }        }      ],      "riskLinks": [        {          "incidentId": "string",          "riskId": "string",          "organizationId": "string",          "linkedAt": "string",          "linkedBy": "string",          "risk": {            "id": "string",            "shortId": -9007199254740991,            "slug": "string",            "name": "string",            "ownerId": "string",            "description": "string",            "createdAt": "string",            "updatedAt": "string",            "archivedAt": "string",            "organizationId": "string",            "threatClassId": "string",            "vulnerabilityClassId": "string",            "impactDescription": "string",            "initialProbabilityRating": -9007199254740991,            "initialImpactRating": -9007199254740991,            "residualProbabilityRating": -9007199254740991,            "residualImpactRating": -9007199254740991,            "treatmentType": "UNKNOWN",            "treatmentDescription": "string"          }        }      ],      "vendorLinks": [        {          "incidentId": "string",          "vendorId": "string",          "organizationId": "string",          "linkedAt": "string",          "linkedBy": "string",          "vendor": {            "id": "string",            "shortId": -9007199254740991,            "slug": "string",            "name": "string",            "description": "string",            "createdAt": "string",            "updatedAt": "string",            "organizationId": "string",            "archivedAt": "string",            "category": "CLOUD",            "relationship": "PROCESSOR",            "status": "ACTIVE",            "inherentProbability": -9007199254740991,            "inherentImpact": -9007199254740991,            "residualProbability": -9007199254740991,            "residualImpact": -9007199254740991,            "treatmentStrategy": "UNKNOWN",            "website": "string",            "contactName": "string",            "contactEmail": "string",            "contractExpiry": "string",            "ownerId": "string",            "locationId": "string",            "assessmentPeriodId": "string",            "lastAssessmentId": "string"          }        }      ],      "controlLinks": [        {          "id": "string",          "controlCoverageId": "string",          "incidentId": "string",          "organizationId": "string",          "linkedAt": "string",          "linkedBy": "string",          "controlCoverage": {            "id": "string",            "frameworkAdoptionId": "string",            "controlId": "string",            "coverageStatus": "FULL",            "coverageGap": "string",            "lastReviewedAt": "string",            "reviewedBy": "string",            "isNotRelevant": true,            "notRelevantReason": "string",            "notRelevantAt": "string",            "notRelevantBy": "string",            "policyId": "string",            "sectionUid": "string",            "organizationId": "string",            "createdAt": "string",            "updatedAt": "string",            "control": {              "id": "string",              "frameworkId": "string",              "parentId": "string",              "identifier": "string",              "slug": "string",              "type": "CATEGORY",              "isMandatory": true,              "name": "string",              "description": null,              "purpose": "string",              "isCentralized": true,              "createdAt": "string",              "updatedAt": "string"            }          }        }      ],      "labels": [        {          "incidentId": "string",          "labelId": "string",          "organizationId": "string",          "label": {            "id": "string",            "slug": "string",            "name": "string",            "scope": "string",            "color": "string",            "createdAt": "string",            "updatedAt": "string",            "archivedAt": "string",            "organizationId": "string"          }        }      ]    }  ],  "total": 0,  "page": 0,  "limit": 0}

How is this guide?