Uptimeify Docs
OrganizationReports

List Reports

Returns all organization report configurations plus the organization's report entitlement (plan feature flag and quota).

GET /api/organization/reports

Lists the organization's recurring report configurations, newest first. The organization is derived from your authenticated session or API token. Available to any organization role, including read-only users.

Example (cURL)

BASE_URL="https://uptimeify.io"
TOKEN="<your-api-token>"

curl -X GET "$BASE_URL/api/organization/reports" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"

Response

{
  "entitlement": { "enabled": true, "limit": 10 },
  "reports": [
    {
      "id": "3f1c9c1e-8d2a-4c7e-9b1a-2d5f6a7b8c90",
      "name": "Weekly Ops Digest",
      "enabled": true,
      "frequency": "weekly",
      "weekday": 1,
      "dayOfMonth": null,
      "sendHour": 2,
      "timezone": "Europe/Berlin",
      "scopeMode": "all",
      "scopeCustomerIds": [],
      "scopeTagIds": [],
      "inclusionMode": "problems",
      "problemSignals": { "incident": true, "downtimeMinutes": 5, "sslDaysLt": 14, "responseBreach": true },
      "thresholdUptimeLt": null,
      "thresholdResponseGt": null,
      "sendWhenEmpty": false,
      "sections": {
        "fleetSummary": true,
        "worstPerformers": true,
        "perSiteTable": true,
        "incidentLog": true,
        "sslExpiry": true,
        "groupByCustomer": false
      },
      "monitorTypes": ["website", "dns", "dnsbl", "domain", "icmp", "smtp", "ssh", "tcp", "ftp", "imap"],
      "sectionsByType": {},
      "groupByCustomer": false,
      "format": "email_pdf",
      "recipientEmails": ["ops@agency.io"],
      "recipientUserIds": [],
      "createdAt": "2026-06-01T02:00:00.000Z",
      "updatedAt": "2026-06-01T02:00:00.000Z"
    }
  ]
}

entitlement.enabled reflects whether the organization's plan includes organization reports; entitlement.limit is the maximum number of report configurations allowed. Both are derived from the organization's active pricing/custom-pricing rows, independent of how many reports currently exist.

Common errors

  • 401 Unauthorized — not authenticated.
  • 403 Forbidden (forbidden) — you do not have access to this organization.

On this page