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.

MethodEndpointDescription
GET/v1/company/reports/governanceGet governance report summary, controls, evidence, unavailable notices, and audit trail entries.

Query Parameters

ParameterTypeDescription
fromstringStart date in YYYY-MM-DD format. Defaults to 30 days ago. The range cannot exceed 366 days.
tostringEnd date in YYYY-MM-DD format. Defaults to today and cannot be in the future.
modestringOne 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

StatusReason
401The API key or OAuth token is missing, invalid, expired, or revoked.
403The company API is disabled, the account is blocked, the required scope is missing, or mail_security is not enabled.
422The date range or mode parameter is invalid.