Governance Reports API
Pull company mail-security governance evidence for compliance reviews, cyber insurance questionnaires, and framework crosswalks.
Required scope
This endpoint requires Company API authentication with reports:read or mail_security.governance:read, and the company must have the mail_security capability.
| Method | Endpoint | Description |
|---|---|---|
| GET | /v1/company/reports/governance | Get governance report summary, controls, evidence, unavailable notices, and audit trail entries. |
Query Parameters
| Parameter | Type | Description |
|---|---|---|
| from | string | Start date in YYYY-MM-DD format. Defaults to 30 days ago. The range cannot exceed 366 days. |
| to | string | End date in YYYY-MM-DD format. Defaults to today and cannot be in the future. |
| mode | string | One of all, generic_controls, cyber_insurance, or framework_crosswalk. |
Response Shape
{
"data": {
"mode": "all",
"report_period": {"from": "2026-04-16", "to": "2026-05-16"},
"generated_at": "2026-05-16T08:00:00Z",
"summary": {
"governance_score": 88,
"protected_domains": 3,
"messages_reviewed": 12450,
"open_threats": 2
},
"capabilities": {"mail_security": true, "training": true},
"control_evidence": [
{
"id": "email_authentication",
"title": "SPF, DKIM, and DMARC posture",
"status": "passed",
"score": 92,
"frameworks": ["ISO 27001 A.8.20", "SOC 2 CC6.6"],
"evidence": ["Average identity score 92"]
}
],
"evidence_matrix": [{"control_id": "email_authentication", "status": "passed"}],
"operational_audit_trail": [],
"unavailable": []
}
}cURL Example
curl -G "https://api.empowsec.com/v1/company/reports/governance" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json" \
--data-urlencode "from=2026-04-01" \
--data-urlencode "to=2026-04-30" \
--data-urlencode "mode=cyber_insurance"Errors
| Status | Reason |
|---|---|
| 401 | The API key or OAuth token is missing, invalid, expired, or revoked. |
| 403 | The company API is disabled, the account is blocked, the required scope is missing, or mail_security is not enabled. |
| 422 | The date range or mode parameter is invalid. |