Skip to main content
GET
/
beta
/
incidents
Get incidents
curl --request GET \
  --url https://api.petrasecurity.com/beta/incidents \
  --header 'Authorization: Bearer <token>'
{
  "incidents": [
    {
      "id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
      "url": "https://app.petrasecurity.com/tenant/tenant-123/incidents/a1b2c3d4-5678-90ab-cdef-1234567890ab",
      "createdAt": "2026-03-15T14:30:00.000Z",
      "occurredAt": "2026-03-15T13:22:00.000Z",
      "remediationStatus": "REMEDIATED",
      "isLive": true,
      "dwellTimeMinutes": 67,
      "tenant": {
        "petraTenantId": "tenant-123",
        "name": "Acme Corporation",
        "microsoftTenantId": "abcd1234-5678-90ef-ghij-klmnopqrstuv"
      },
      "user": {
        "id": "user-id-1",
        "userPrincipalName": "john.doe@acmecorp.com",
        "mail": "john.doe@acmecorp.com",
        "displayName": "John Doe",
        "accountEnabled": true,
        "lastPasswordChangeDateTime": "2026-03-15T15:00:00.000Z"
      }
    }
  ]
}

Authorizations

Authorization
string
header
required

Bearer token authentication. Include your API key in the Authorization header as 'Bearer YOUR_API_KEY'

Query Parameters

tenantId
string

Filter incidents to a specific tenant. Accepts either a Petra tenant ID or a Microsoft tenant ID. Your Petra tenant ID can be found in the URL when viewing a tenant in the dashboard (e.g. app.petrasecurity.com/tenant/).

startDate
string<date-time>

Only return incidents created on or after this date. Accepts ISO 8601 format — either date only (e.g. 2026-03-01) or full date-time (e.g. 2026-03-05T00:53:10.402Z).

limit
integer
default:100

Maximum number of incidents to return. Defaults to 100, maximum 500.

Required range: 1 <= x <= 500

Response

Successful response

incidents
object[]

Array of incident objects