Skip to main content
GET
Get posture reports
For common API errors, see API Troubleshooting.
This route is limited to 10 requests per minute.
Posture reports are generated from the Petra dashboard under Reporting, then Posture Report. This endpoint returns completed reports only. By default you get the latest report for each tenant; pass latestOnly=false to see report history. Each report includes every assessed control under checks. Values reflect any edits made to the report in the dashboard, so the API matches the PDF your clients see. You can find a tenant’s Petra ID in the URL when viewing a tenant in the dashboard (e.g. app.petrasecurity.com/tenant/<tenantId>). You can also pass a Microsoft tenant ID and the endpoint will resolve it automatically.

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 to a specific tenant. Accepts either a Petra tenant ID or a Microsoft tenant ID. You can find a tenant's Petra ID in the URL when viewing a tenant in the dashboard (e.g. app.petrasecurity.com/tenant/). Returns 404 if the tenant is not in your organization.

latestOnly
boolean
default:true

When true (the default), return only the most recent completed report per tenant. Set to false to return report history, newest first.

startDate
string<date-time>

Only return reports completed 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 reports to return. Defaults to 100, maximum 500.

Required range: 1 <= x <= 500

Response

Successful response

totalReports
integer

Number of reports in this response

reports
object[]