Alerts

Resource	Operation	Description
Alerts	GET /reports/(string:report_id)/alerts/(string:alert_id)	Get the events for a specific alert.
	GET /reports/(string:id)/alerts	Get the list of alerts for a specific report.

GET /reports/(string: report_id)/alerts/(string: alert_id)

Get the list of events for a specific alert.

Example request:

GET /reports/RVEEAHJDHQUS/alerts/1471321 HTTP/1.1
Host: api.saucs.com
Accept: application/json

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

[
  {
      "created_at": "2017-10-04 14:30:21Z",
      "details": {
          "added": [
              {
                  "cpe_id": 211536,
                  "product": "linux_kernel",
                  "uri": "cpe:/o:linux:linux_kernel:4.13.3",
                  "vendor": "linux",
                  "version": "4.13.3"
              }
          ],
          "removed": []
      },
      "type": "CPEs changed"
  },
  {
      "created_at": "2017-10-04 14:30:21Z",
      "details": {
          "action": "added",
          "id": 90840,
          "new_score": "6.8"
      },
      "type": "CVSS changed"
  },
  {
      "created_at": "2017-10-04 14:30:21Z",
      "details": {
          "added": [],
          "changed": [
              {
                  "id": 460762,
                  "key": "type",
                  "link": "https://marc.info/?t=150525503100001&r=1&w=2",
                  "new_value": "VENDOR_ADVISORY",
                  "old_value": "UNKNOWN"
              },
              {
                  "id": 460325,
                  "key": "type",
                  "link": "https://bugzilla.novell.com/show_bug.cgi?id=1058410",
                  "new_value": "VENDOR_ADVISORY",
                  "old_value": "UNKNOWN"
              },
              {
                  "id": 460324,
                  "key": "type",
                  "link": "http://seclists.org/oss-sec/2017/q3/437",
                  "new_value": "VENDOR_ADVISORY",
                  "old_value": "UNKNOWN"
              },
              {
                  "id": 460327,
                  "key": "type",
                  "link": "https://git.kernel.org/pub/scm/linux/kernel/git/jberg/mac80211.git/commit/?id=e785fa0a164aa11001cba931367c7f94ffaff888",
                  "new_value": "VENDOR_ADVISORY",
                  "old_value": "UNKNOWN"
              },
              {
                  "id": 460948,
                  "key": "type",
                  "link": "http://www.securityfocus.com/bid/100855",
                  "new_value": "VENDOR_ADVISORY",
                  "old_value": "UNKNOWN"
              },
              {
                  "id": 460326,
                  "key": "type",
                  "link": "https://bugzilla.redhat.com/show_bug.cgi?id=1491046",
                  "new_value": "VENDOR_ADVISORY",
                  "old_value": "UNKNOWN"
              }
          ],
          "removed": []
      },
      "type": "References changed"
  },
  {
      "created_at": "2017-10-04 14:30:21Z",
      "details": {
          "added": [
              "CWE-476"
          ],
          "removed": []
      },
      "type": "CWEs changed"
  }
]

Response Headers:  

• Content-Type – application/json

Status Codes:

• 200 OK – list of reports found
• 404 Not Found – report not found
• 404 Not Found – alert not found

GET /reports/(string: id)/alerts

Get the list of alerts for a specific report.

Example request:

GET /reports/RVEEAHJDHQUS/alerts HTTP/1.1
Host: api.saucs.com
Accept: application/json

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

[
  {
      "handlers": {
          "products": [],
          "vendors": [
              "apache"
          ]
      },
      "created_at": "2017-10-04 14:31:00Z",
      "cve": "CVE-2017-9805",
      "id": 1470907
  },
  {
      "handlers": {
          "products": [
              "linux_kernel"
          ],
          "vendors": []
      },
      "created_at": "2017-10-04 14:31:14Z",
      "cve": "CVE-2017-12153",
      "id": 1471321
  },
  {
      "handlers": {
          "products": [],
          "vendors": [
              "apache"
          ]
      },
      "created_at": "2017-10-04 18:31:07Z",
      "cve": "CVE-2017-9803",
      "id": 1471614
  }
]

Response Headers:  

• Content-Type – application/json

Status Codes:

• 200 OK – list of alerts found
• 404 Not Found – report not found