{
  "info": {
    "_postman_id": "3194a786-d3ce-49f5-b347-58660687dba1",
    "name": "SaaS Alerts Events Reports API",
    "description": "The SaaS Alerts API provides programmatic access to the SaaS Alerts security monitoring platform for MSPs. The API enables querying of security events, alerts, and user behavior data detected across monitored SaaS applications including Microsoft 365, Google Workspace, Salesforce, Slack, and Dropbox. Authentication uses API keys generated from the SaaS Alerts management interface.\n\nContact Support:\n Name: SaaS Alerts Support",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "createdAt": "2026-07-28T02:49:43.000Z",
    "updatedAt": "2026-07-28T02:49:43.000Z",
    "lastUpdatedBy": "35240",
    "uid": "35240-3194a786-d3ce-49f5-b347-58660687dba1"
  },
  "item": [
    {
      "name": "reports",
      "item": [
        {
          "name": "alerts",
          "item": [
            {
              "name": "List Security Alerts",
              "id": "72f79424-db53-44a3-ac6f-592a369305cb",
              "protocolProfileBehavior": {
                "disableBodyPruning": true
              },
              "request": {
                "auth": {
                  "type": "apikey",
                  "apikey": [
                    {
                      "key": "key",
                      "value": "X-API-Key",
                      "type": "string"
                    },
                    {
                      "key": "value",
                      "value": "{{apiKey}}",
                      "type": "string"
                    },
                    {
                      "key": "in",
                      "value": "header",
                      "type": "string"
                    }
                  ]
                },
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/reports/alerts?alertStatus=medium&resolved=<boolean>&customerId=<string>&startDate=<dateTime>&endDate=<dateTime>&pageSize=25&page=1",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "reports",
                    "alerts"
                  ],
                  "query": [
                    {
                      "description": "Filter alerts by severity",
                      "key": "alertStatus",
                      "value": "medium"
                    },
                    {
                      "description": "Filter by resolution status",
                      "key": "resolved",
                      "value": "<boolean>"
                    },
                    {
                      "description": "Filter by customer identifier",
                      "key": "customerId",
                      "value": "<string>"
                    },
                    {
                      "description": "Filter alerts from this date",
                      "key": "startDate",
                      "value": "<dateTime>"
                    },
                    {
                      "description": "Filter alerts up to this date",
                      "key": "endDate",
                      "value": "<dateTime>"
                    },
                    {
                      "description": "Number of alerts per page",
                      "key": "pageSize",
                      "value": "25"
                    },
                    {
                      "description": "Page number for pagination",
                      "key": "page",
                      "value": "1"
                    }
                  ]
                },
                "description": "Returns a list of active and historical security alerts across all monitored customers and applications. Alerts are generated when anomalous or suspicious behavior is detected."
              },
              "response": [
                {
                  "id": "c6b0e419-724d-4f36-bde9-443c8af49b38",
                  "name": "List of security alerts",
                  "originalRequest": {
                    "method": "GET",
                    "header": [
                      {
                        "key": "Accept",
                        "value": "application/json"
                      },
                      {
                        "description": "Added as a part of security scheme: apikey",
                        "key": "X-API-Key",
                        "value": "<API Key>"
                      }
                    ],
                    "url": {
                      "raw": "{{baseUrl}}/reports/alerts?alertStatus=medium&resolved=<boolean>&customerId=<string>&startDate=<dateTime>&endDate=<dateTime>&pageSize=25&page=1",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "reports",
                        "alerts"
                      ],
                      "query": [
                        {
                          "description": "Filter alerts by severity",
                          "key": "alertStatus",
                          "value": "medium"
                        },
                        {
                          "description": "Filter by resolution status",
                          "key": "resolved",
                          "value": "<boolean>"
                        },
                        {
                          "description": "Filter by customer identifier",
                          "key": "customerId",
                          "value": "<string>"
                        },
                        {
                          "description": "Filter alerts from this date",
                          "key": "startDate",
                          "value": "<dateTime>"
                        },
                        {
                          "description": "Filter alerts up to this date",
                          "key": "endDate",
                          "value": "<dateTime>"
                        },
                        {
                          "description": "Number of alerts per page",
                          "key": "pageSize",
                          "value": "25"
                        },
                        {
                          "description": "Page number for pagination",
                          "key": "page",
                          "value": "1"
                        }
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "cookie": [],
                  "responseTime": null,
                  "body": "{\n  \"alerts\": [\n    {\n      \"alertId\": \"<string>\",\n      \"alertStatus\": \"low\",\n      \"title\": \"<string>\",\n      \"description\": \"<string>\",\n      \"customerId\": \"<string>\",\n      \"customerName\": \"<string>\",\n      \"application\": \"<string>\",\n      \"userId\": \"<string>\",\n      \"resolved\": \"<boolean>\",\n      \"createdAt\": \"<dateTime>\",\n      \"resolvedAt\": \"<dateTime>\",\n      \"relatedEvents\": [\n        \"<string>\",\n        \"<string>\"\n      ]\n    },\n    {\n      \"alertId\": \"<string>\",\n      \"alertStatus\": \"low\",\n      \"title\": \"<string>\",\n      \"description\": \"<string>\",\n      \"customerId\": \"<string>\",\n      \"customerName\": \"<string>\",\n      \"application\": \"<string>\",\n      \"userId\": \"<string>\",\n      \"resolved\": \"<boolean>\",\n      \"createdAt\": \"<dateTime>\",\n      \"resolvedAt\": \"<dateTime>\",\n      \"relatedEvents\": [\n        \"<string>\",\n        \"<string>\"\n      ]\n    }\n  ],\n  \"pagination\": {\n    \"page\": \"<integer>\",\n    \"pageSize\": \"<integer>\",\n    \"totalPages\": \"<integer>\",\n    \"totalCount\": \"<integer>\"\n  }\n}",
                  "createdAt": "2026-07-28T02:49:43.000Z",
                  "updatedAt": "2026-07-28T02:49:43.000Z",
                  "uid": "35240-c6b0e419-724d-4f36-bde9-443c8af49b38"
                },
                {
                  "id": "5258d9a4-0607-47e0-b286-d19e2d9e0985",
                  "name": "Unauthorized",
                  "originalRequest": {
                    "method": "GET",
                    "header": [
                      {
                        "description": "Added as a part of security scheme: apikey",
                        "key": "X-API-Key",
                        "value": "<API Key>"
                      }
                    ],
                    "url": {
                      "raw": "{{baseUrl}}/reports/alerts?alertStatus=medium&resolved=<boolean>&customerId=<string>&startDate=<dateTime>&endDate=<dateTime>&pageSize=25&page=1",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "reports",
                        "alerts"
                      ],
                      "query": [
                        {
                          "description": "Filter alerts by severity",
                          "key": "alertStatus",
                          "value": "medium"
                        },
                        {
                          "description": "Filter by resolution status",
                          "key": "resolved",
                          "value": "<boolean>"
                        },
                        {
                          "description": "Filter by customer identifier",
                          "key": "customerId",
                          "value": "<string>"
                        },
                        {
                          "description": "Filter alerts from this date",
                          "key": "startDate",
                          "value": "<dateTime>"
                        },
                        {
                          "description": "Filter alerts up to this date",
                          "key": "endDate",
                          "value": "<dateTime>"
                        },
                        {
                          "description": "Number of alerts per page",
                          "key": "pageSize",
                          "value": "25"
                        },
                        {
                          "description": "Page number for pagination",
                          "key": "page",
                          "value": "1"
                        }
                      ]
                    }
                  },
                  "status": "Unauthorized",
                  "code": 401,
                  "_postman_previewlanguage": "text",
                  "header": [],
                  "cookie": [],
                  "responseTime": null,
                  "body": null,
                  "createdAt": "2026-07-28T02:49:43.000Z",
                  "updatedAt": "2026-07-28T02:49:43.000Z",
                  "uid": "35240-5258d9a4-0607-47e0-b286-d19e2d9e0985"
                }
              ],
              "createdAt": "2026-07-28T02:49:43.000Z",
              "updatedAt": "2026-07-28T02:49:43.000Z",
              "uid": "35240-72f79424-db53-44a3-ac6f-592a369305cb"
            }
          ],
          "id": "6121834d-e8c7-4bd0-88a1-05addab6623a",
          "createdAt": "2026-07-28T02:49:43.000Z",
          "updatedAt": "2026-07-28T02:49:43.000Z",
          "uid": "35240-6121834d-e8c7-4bd0-88a1-05addab6623a"
        },
        {
          "name": "customers",
          "item": [
            {
              "name": "List Monitored Customers",
              "id": "f64a49f0-397a-41d6-a560-a4de5fbdc3d0",
              "protocolProfileBehavior": {
                "disableBodyPruning": true
              },
              "request": {
                "auth": {
                  "type": "apikey",
                  "apikey": [
                    {
                      "key": "key",
                      "value": "X-API-Key",
                      "type": "string"
                    },
                    {
                      "key": "value",
                      "value": "{{apiKey}}",
                      "type": "string"
                    },
                    {
                      "key": "in",
                      "value": "header",
                      "type": "string"
                    }
                  ]
                },
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/reports/customers?pageSize=25&page=1",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "reports",
                    "customers"
                  ],
                  "query": [
                    {
                      "description": "Number of customers per page",
                      "key": "pageSize",
                      "value": "25"
                    },
                    {
                      "description": "Page number for pagination",
                      "key": "page",
                      "value": "1"
                    }
                  ]
                },
                "description": "Returns a list of MSP customer tenants being monitored by the SaaS Alerts platform."
              },
              "response": [
                {
                  "id": "fbc34701-6756-47b6-a4e3-56f7fe52bae8",
                  "name": "List of monitored customers",
                  "originalRequest": {
                    "method": "GET",
                    "header": [
                      {
                        "key": "Accept",
                        "value": "application/json"
                      },
                      {
                        "description": "Added as a part of security scheme: apikey",
                        "key": "X-API-Key",
                        "value": "<API Key>"
                      }
                    ],
                    "url": {
                      "raw": "{{baseUrl}}/reports/customers?pageSize=25&page=1",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "reports",
                        "customers"
                      ],
                      "query": [
                        {
                          "description": "Number of customers per page",
                          "key": "pageSize",
                          "value": "25"
                        },
                        {
                          "description": "Page number for pagination",
                          "key": "page",
                          "value": "1"
                        }
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "cookie": [],
                  "responseTime": null,
                  "body": "{\n  \"customers\": [\n    {\n      \"customerId\": \"<string>\",\n      \"name\": \"<string>\",\n      \"applications\": [\n        \"<string>\",\n        \"<string>\"\n      ],\n      \"userCount\": \"<integer>\",\n      \"status\": \"inactive\",\n      \"createdAt\": \"<dateTime>\"\n    },\n    {\n      \"customerId\": \"<string>\",\n      \"name\": \"<string>\",\n      \"applications\": [\n        \"<string>\",\n        \"<string>\"\n      ],\n      \"userCount\": \"<integer>\",\n      \"status\": \"active\",\n      \"createdAt\": \"<dateTime>\"\n    }\n  ],\n  \"pagination\": {\n    \"page\": \"<integer>\",\n    \"pageSize\": \"<integer>\",\n    \"totalPages\": \"<integer>\",\n    \"totalCount\": \"<integer>\"\n  }\n}",
                  "createdAt": "2026-07-28T02:49:43.000Z",
                  "updatedAt": "2026-07-28T02:49:43.000Z",
                  "uid": "35240-fbc34701-6756-47b6-a4e3-56f7fe52bae8"
                },
                {
                  "id": "3353c664-e5dd-4cf6-92af-e4fd30b3cbbf",
                  "name": "Unauthorized",
                  "originalRequest": {
                    "method": "GET",
                    "header": [
                      {
                        "description": "Added as a part of security scheme: apikey",
                        "key": "X-API-Key",
                        "value": "<API Key>"
                      }
                    ],
                    "url": {
                      "raw": "{{baseUrl}}/reports/customers?pageSize=25&page=1",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "reports",
                        "customers"
                      ],
                      "query": [
                        {
                          "description": "Number of customers per page",
                          "key": "pageSize",
                          "value": "25"
                        },
                        {
                          "description": "Page number for pagination",
                          "key": "page",
                          "value": "1"
                        }
                      ]
                    }
                  },
                  "status": "Unauthorized",
                  "code": 401,
                  "_postman_previewlanguage": "text",
                  "header": [],
                  "cookie": [],
                  "responseTime": null,
                  "body": null,
                  "createdAt": "2026-07-28T02:49:43.000Z",
                  "updatedAt": "2026-07-28T02:49:43.000Z",
                  "uid": "35240-3353c664-e5dd-4cf6-92af-e4fd30b3cbbf"
                }
              ],
              "createdAt": "2026-07-28T02:49:43.000Z",
              "updatedAt": "2026-07-28T02:49:43.000Z",
              "uid": "35240-f64a49f0-397a-41d6-a560-a4de5fbdc3d0"
            }
          ],
          "id": "d7425e15-a3c0-4f16-9304-1daaea1b6347",
          "createdAt": "2026-07-28T02:49:43.000Z",
          "updatedAt": "2026-07-28T02:49:43.000Z",
          "uid": "35240-d7425e15-a3c0-4f16-9304-1daaea1b6347"
        },
        {
          "name": "users",
          "item": [
            {
              "name": "List Monitored Users",
              "id": "d7a1f245-f3dd-4b75-a114-e35006fd2eea",
              "protocolProfileBehavior": {
                "disableBodyPruning": true
              },
              "request": {
                "auth": {
                  "type": "apikey",
                  "apikey": [
                    {
                      "key": "key",
                      "value": "X-API-Key",
                      "type": "string"
                    },
                    {
                      "key": "value",
                      "value": "{{apiKey}}",
                      "type": "string"
                    },
                    {
                      "key": "in",
                      "value": "header",
                      "type": "string"
                    }
                  ]
                },
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/reports/users?customerId=<string>&application=<string>&pageSize=25&page=1",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "reports",
                    "users"
                  ],
                  "query": [
                    {
                      "description": "Filter by customer identifier",
                      "key": "customerId",
                      "value": "<string>"
                    },
                    {
                      "description": "Filter by application",
                      "key": "application",
                      "value": "<string>"
                    },
                    {
                      "description": "Number of users per page",
                      "key": "pageSize",
                      "value": "25"
                    },
                    {
                      "description": "Page number for pagination",
                      "key": "page",
                      "value": "1"
                    }
                  ]
                },
                "description": "Returns a list of users across monitored customer tenants. Includes user activity summary and risk indicators."
              },
              "response": [
                {
                  "id": "4bb870ce-0774-4f35-9305-44c11fa10393",
                  "name": "List of monitored users",
                  "originalRequest": {
                    "method": "GET",
                    "header": [
                      {
                        "key": "Accept",
                        "value": "application/json"
                      },
                      {
                        "description": "Added as a part of security scheme: apikey",
                        "key": "X-API-Key",
                        "value": "<API Key>"
                      }
                    ],
                    "url": {
                      "raw": "{{baseUrl}}/reports/users?customerId=<string>&application=<string>&pageSize=25&page=1",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "reports",
                        "users"
                      ],
                      "query": [
                        {
                          "description": "Filter by customer identifier",
                          "key": "customerId",
                          "value": "<string>"
                        },
                        {
                          "description": "Filter by application",
                          "key": "application",
                          "value": "<string>"
                        },
                        {
                          "description": "Number of users per page",
                          "key": "pageSize",
                          "value": "25"
                        },
                        {
                          "description": "Page number for pagination",
                          "key": "page",
                          "value": "1"
                        }
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "cookie": [],
                  "responseTime": null,
                  "body": "{\n  \"users\": [\n    {\n      \"userId\": \"<string>\",\n      \"customerId\": \"<string>\",\n      \"customerName\": \"<string>\",\n      \"applications\": [\n        \"<string>\",\n        \"<string>\"\n      ],\n      \"lastActivity\": \"<dateTime>\",\n      \"riskScore\": \"<integer>\",\n      \"alertCount\": \"<integer>\"\n    },\n    {\n      \"userId\": \"<string>\",\n      \"customerId\": \"<string>\",\n      \"customerName\": \"<string>\",\n      \"applications\": [\n        \"<string>\",\n        \"<string>\"\n      ],\n      \"lastActivity\": \"<dateTime>\",\n      \"riskScore\": \"<integer>\",\n      \"alertCount\": \"<integer>\"\n    }\n  ],\n  \"pagination\": {\n    \"page\": \"<integer>\",\n    \"pageSize\": \"<integer>\",\n    \"totalPages\": \"<integer>\",\n    \"totalCount\": \"<integer>\"\n  }\n}",
                  "createdAt": "2026-07-28T02:49:43.000Z",
                  "updatedAt": "2026-07-28T02:49:43.000Z",
                  "uid": "35240-4bb870ce-0774-4f35-9305-44c11fa10393"
                },
                {
                  "id": "a4f45086-e862-4c39-af84-b0893c895a07",
                  "name": "Unauthorized",
                  "originalRequest": {
                    "method": "GET",
                    "header": [
                      {
                        "description": "Added as a part of security scheme: apikey",
                        "key": "X-API-Key",
                        "value": "<API Key>"
                      }
                    ],
                    "url": {
                      "raw": "{{baseUrl}}/reports/users?customerId=<string>&application=<string>&pageSize=25&page=1",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "reports",
                        "users"
                      ],
                      "query": [
                        {
                          "description": "Filter by customer identifier",
                          "key": "customerId",
                          "value": "<string>"
                        },
                        {
                          "description": "Filter by application",
                          "key": "application",
                          "value": "<string>"
                        },
                        {
                          "description": "Number of users per page",
                          "key": "pageSize",
                          "value": "25"
                        },
                        {
                          "description": "Page number for pagination",
                          "key": "page",
                          "value": "1"
                        }
                      ]
                    }
                  },
                  "status": "Unauthorized",
                  "code": 401,
                  "_postman_previewlanguage": "text",
                  "header": [],
                  "cookie": [],
                  "responseTime": null,
                  "body": null,
                  "createdAt": "2026-07-28T02:49:43.000Z",
                  "updatedAt": "2026-07-28T02:49:43.000Z",
                  "uid": "35240-a4f45086-e862-4c39-af84-b0893c895a07"
                }
              ],
              "createdAt": "2026-07-28T02:49:43.000Z",
              "updatedAt": "2026-07-28T02:49:43.000Z",
              "uid": "35240-d7a1f245-f3dd-4b75-a114-e35006fd2eea"
            }
          ],
          "id": "215dd5bf-0873-4315-b61d-de588709b651",
          "createdAt": "2026-07-28T02:49:43.000Z",
          "updatedAt": "2026-07-28T02:49:43.000Z",
          "uid": "35240-215dd5bf-0873-4315-b61d-de588709b651"
        }
      ],
      "id": "599ac206-d825-4c73-91f5-c1a0631b1c79",
      "createdAt": "2026-07-28T02:49:43.000Z",
      "updatedAt": "2026-07-28T02:49:43.000Z",
      "uid": "35240-599ac206-d825-4c73-91f5-c1a0631b1c79"
    }
  ],
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.saasalerts.com"
    }
  ]
}