Skip to main content
GET
Get Petra identity summary

Authorizations

Authorization
string
header
required

Use your API key as a Bearer token. API keys can be generated in Settings → Integrations → API Access.

Query Parameters

companyId
string<uuid>

Restrict to one company

periodStart
string

First day of the period (YYYY-MM-DD)

Pattern: ^\d{4}-\d{2}-\d{2}$
periodEnd
string

Last day of the period (YYYY-MM-DD)

Pattern: ^\d{4}-\d{2}-\d{2}$

Response

Petra identity summary

data
object
required

Incidents cover the period (live vs historical, open vs remediated, median dwell, openNow, top incidents); failed sign-in attacks are each tenant's latest 30-day window and posture is each tenant's latest report.