Skip to main content
GET
/
beta
/
usage-xlsx
Download usage spreadsheet
curl --request GET \
  --url https://api.petrasecurity.com/beta/usage-xlsx \
  --header 'Authorization: Bearer <token>'
"<string>"
This endpoint requires a Multi-MSP API Key (prefixed petra_var_), which is different from the standard Org API Key used by other endpoints. Contact support@petrasecurity.com if you need a Multi-MSP API Key.
The response is a binary .xlsx file. When using cURL, save the output to a file: 
curl -H "Authorization: Bearer YOUR_MULTI_MSP_API_KEY" \
  -o usage-report.xlsx \
  "https://api.petrasecurity.com/beta/usage-xlsx?asOf=2026-03-01"

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
asOf
string<date>

Date in ISO format (YYYY-MM-DD) to generate the usage report for. Defaults to the current date if not provided.

Response

Excel spreadsheet containing tenant usage data

The response is of type file.