---
title: "Get scan results"
method: GET
path: "/_api/vendors/scan"
tags: ["Vendor risk"]
---

# Get scan results

`GET /_api/vendors/scan`

## Request

- Base URL: `https://shadowalpha.online`
- URL: `https://shadowalpha.online/_api/vendors/scan`
- Auth: none declared

Progress and results of a vendor scan: one row per vendor (hosting, category, cloud region, country, confidence, CDN, whether the origin is hidden, DNS, email, TLS issuer and expiry) plus a portfolio summary (share per provider and layer, critical vendors, failure scenarios, expiring certificates and domains) and the provider incident history.

## Query parameters

- `id` string, required

## Response `200`

status = queued | running | done | failed.

- object
  - `id` string
  - `status` string
  - `total` integer
  - `done` integer
  - `rows` object[]
  - `summary` object
  - `providerIncidents` object[]
  - `expiresAt` string, date-time

## Other responses

- `404`: Unknown or expired scan.

---

[API](https://skmtc.dev/shadowalpha/apis/shadowgraph-api.md) · [All operations](https://skmtc.dev/shadowalpha/apis/shadowgraph-api/llms.txt) · [OpenAPI document](https://skmtc.dev/shadowalpha/apis/shadowgraph-api/revisions/1b62d5453408?raw)