Skip to main content
GET
/
mac-address
/
cves
Get CVEs by MAC Address
curl --request GET \
  --url https://api.altostrat.io/scans/cve/mac-address/cves \
  --header 'Authorization: Bearer <token>'
{
  "mac_address": "<string>",
  "total_scans": 123,
  "total_cve_instances": 123,
  "stats": {
    "unique_cve_count": 123,
    "highest_score": 123,
    "average_score": 123
  },
  "cves": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "cve_id": "CVE-2021-44228",
      "description": "<string>",
      "published_at": "2023-11-07T05:31:56Z",
      "created_at": "2023-11-07T05:31:56Z",
      "vector": "<string>",
      "score": 123,
      "severity": "NONE",
      "assigner": "<string>",
      "references": [
        [
          {
            "url": "http://example.com/ref",
            "name": "Example Ref"
          }
        ]
      ],
      "cve_detail": {
        "cvss_version": "<string>",
        "vector": "<string>",
        "base_score": 123,
        "severity": "<string>",
        "impact_score": 123,
        "exploitability_score": 123,
        "metrics": {
          "attack_vector": "<string>",
          "attack_complexity": "<string>",
          "privileges_required": "<string>",
          "user_interaction": "<string>",
          "scope": "<string>",
          "confidentiality": "<string>",
          "integrity": "<string>",
          "availability": "<string>"
        }
      },
      "scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "compliance_tags": [
        "PCI-DSS"
      ],
      "host": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "hostname": "<string>",
        "mac_address": "<string>",
        "manufacturer": "<string>",
        "ip_address": "127.0.0.1"
      },
      "status": "open",
      "other_occurrences": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "host_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "created_at": "2023-11-07T05:31:56Z"
        }
      ]
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Authentication token obtained via Altostrat platform login.

Query Parameters

​
mac_address
string
required

The MAC address to search for (e.g., 00:1A:2B:3C:4D:5E).

​
min_cve_score
number

Optional minimum CVSS score to filter results (0.0-10.0).

Required range: 0 <= x <= 10

Response

Detailed CVE information for the MAC address.

Detailed CVE information for a specific MAC address, grouped by CVE ID.

​
mac_address
string
​
total_scans
integer

Number of scans where this MAC address was detected.

​
total_cve_instances
integer

Total number of CVE findings across all scans for this MAC.

​
stats
object
​
cves
object[]

List of unique CVEs found on this MAC address. Includes details of the first occurrence and references to others.

⌘I