Skip to content
Install Core free
ProductsCompare Core, Hub, Connect and MDM pricing
Solutions
Docs
ResearchPricing
CompareCompare all AI data-leak tools
TrustBenchmarks
Start 30-day free trial

Shadow Hub for your business

Tell us about your team and we'll help you get started.

We use these details only to reply to your enquiry. No newsletter, no cookies, no trackers.

Evidence API

Shadow Hub knows which AI services your people use, what Shadow masked or blocked, and which machines are protected. The Evidence API serves that to compliance platforms as evidence for specific controls. It returns counts, statuses and summaries only: prompts and original values are never part of it, whatever sharing level your organisation uses.

In Shadow Hub, open Integrations, pick the platform and click Connect. Hub creates a key for that platform and shows it once:

shc_live_5Qd0Y... base URL: https://hub.getshadow.dev/connect/v1

Keys are read-only and limited to your organisation. Hub stores only a hash, shows when each key was last used, and records creating and revoking keys in the settings history. Revoke a key on the same page; it stops working immediately.

Send the key as a bearer token: Authorization: Bearer shc_live_.... window is 7d, 30d (default) or 90d.

MethodPathReturns
GET/connect/v1/orgOrganisation, sharing level and plan
GET/connect/v1/evidence?window=30dThe evidence pack (below)
GET/connect/v1/evidence.csv?window=30dOne row per control, for spreadsheets and manual uploads
GET/connect/v1/controlsThe control catalogue and its framework mappings, without metrics
GET/connect/v1/ai-inventory?window=30dAI services and apps in use, unprotected apps, extension and MCP server counts
GET/connect/v1/coveragePeople, machines, and when each machine last reported
GET/connect/v1/incidents?window=30d&limit=50Masked and blocked requests: time, service, app, action and counts per kind

A wrong or revoked key gets 401 {"error": "invalid_key"}.

Terminal window
curl -s https://hub.getshadow.dev/connect/v1/evidence?window=30d \
-H "Authorization: Bearer $SHADOW_EVIDENCE_KEY"
{
"schema": "shadow.evidence/v1",
"org": {"id": "org_...", "name": "Acme GmbH"},
"window": "30d", "from": 1793000000000, "to": 1795600000000, "generated_at": 1795600000000,
"source": {"product": "Shadow Hub", "url": "https://hub.getshadow.dev"},
"coverage": {"people": 12, "devices": 15, "active_devices": 14},
"totals": {"requests": 5210, "masked": 1032, "blocked": 4, "clean": 4174, "unprotected": 0, "values_protected": 4210},
"controls": [
{
"id": "SHD-01",
"title": "Sensitive data is masked before it reaches AI services",
"status": "pass",
"summary": "4,210 values masked in 1,032 AI requests across 14 devices in the last 30 days.",
"metrics": {"masked": 1032, "values_protected": 4210},
"frameworks": {"soc2": ["CC6.1", "CC6.7"], "iso27001": ["A.8.12", "A.5.12"], "iso42001": ["A.7.4"],
"eu_ai_act": [], "gdpr": ["Art. 25", "Art. 32"], "hipaa": ["164.312(e)(1)"]}
}
],
"ai_inventory": {"providers": [...], "clients": [...], "unprotected": [...]}
}

Times are Unix milliseconds. status is pass, attention or no_data (nothing reported in the window).

IdControlSOC 2ISO 27001ISO 42001EU AI ActGDPRHIPAA
SHD-01Sensitive data is masked before it reaches AI servicesCC6.1, CC6.7A.8.12, A.5.12A.7.4Art. 25, 32164.312(e)(1)
SHD-02Prohibited data is blocked from AI servicesCC6.7A.8.12A.7.4Art. 32164.312(e)(1)
SHD-03AI services in use are inventoriedCC2.1, CC9.2A.5.9, A.5.23A.4.2, A.6.2.6Art. 26Art. 30164.308(a)(1)(ii)(A)
SHD-04Unprotected AI usage is detected and reportedCC7.2A.8.16A.6.2.6Art. 26Art. 32164.308(a)(1)(ii)(D)
SHD-05Endpoint protection covers enrolled machinesCC6.8A.8.1, A.8.7A.4.5Art. 32164.310(b)
SHD-06AI activity records are tamper-evidentCC7.2, CC4.1A.8.15A.6.2.8Art. 12Art. 5(2)164.312(b)
SHD-07AI extensions, MCP servers and plugins are reviewedCC6.8, CC8.1A.8.19A.10.3

ISO/IEC 27001 references are to the 2022 Annex A. Mappings say where Shadow’s evidence supports a control; your auditor decides whether it is sufficient on its own. SHD-06 is backed by the evidence receipts every Shadow machine signs.