{"openapi":"3.1.0","info":{"title":"ORBIT public API","version":"1.0.0","description":"Free, read-only, keyless JSON of ORBIT's cached security aggregates. GET only. Rate limit: 120 requests/min per IP. No personal data, no raw indicators. Automated analysis; correlation is not causation.","license":{"name":"Data under each source's licence; see /api/v1/sources"}},"servers":[{"url":"https://www.chyp.ai"}],"paths":{"/api/v1":{"get":{"summary":"Index of endpoints","operationId":"index","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"},"example":{"ok":true,"version":"1","data":{"version":"1","endpoints":[{"path":"/api/v1/kev","params":["days","limit"],"cacheSeconds":300}]}}}}},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/api/v1/kev":{"get":{"summary":"CISA KEV entries added in the last N days, with ATT&CK techniques where mapped","operationId":"kev","parameters":[{"name":"days","in":"query","required":false,"description":"Look-back window in days","schema":{"type":"integer","minimum":1,"maximum":365,"default":30}},{"name":"limit","in":"query","required":false,"description":"Max items (1-500)","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"},"example":{"ok":true,"version":"1","data":[{"cve":"CVE-2026-12345","vendor":"Example","product":"Gateway","dateAdded":"2026-11-20","ransomwareUse":"Unknown","cwes":["CWE-78"],"attack":[{"id":"T1190","name":"Exploit Public-Facing Application"}]}]}}}},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/api/v1/kev/summary":{"get":{"summary":"KEV totals, monthly additions, top vendors, ransomware-use share","operationId":"kev_summary","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"},"example":{"ok":true,"version":"1","data":{"total":1790,"last7":9,"topVendors":[["Microsoft",360]]}}}}},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/api/v1/cves/recent":{"get":{"summary":"CVEs published in the last 24 h by severity, plus the newest CVEs (NVD)","operationId":"cves_recent","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"},"example":{"ok":true,"version":"1","data":{"total":738,"bySeverity":{"CRITICAL":2,"HIGH":40}}}}}},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/api/v1/epss":{"get":{"summary":"Highest EPSS scores today, and EPSS for the newest KEV entries (FIRST)","operationId":"epss","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"},"example":{"ok":true,"version":"1","data":{"top":[{"cve":"CVE-2026-0001","epss":0.97,"percentile":1}]}}}}},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/api/v1/attack":{"get":{"summary":"Top MITRE ATT&CK tactics and techniques behind KEV additions (7 and 30 days)","operationId":"attack","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"},"example":{"ok":true,"version":"1","data":{"d7":{"tactics":[["initial-access",5]],"techniques":[["T1190",5]]}}}}}},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/api/v1/outages":{"get":{"summary":"Tracked services whose own status page reports a problem, and open incidents","operationId":"outages","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"},"example":{"ok":true,"version":"1","data":{"reporting":[{"service":"zoom","indicator":"maintenance","description":"Service Under Maintenance"}],"openIncidents":[]}}}}},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/api/v1/threats/summary":{"get":{"summary":"Aggregates only: SANS ISC InfoCon and top ports, phishing by brand/TLD, botnet C2 count by country, Exploit-DB index counts","operationId":"threats_summary","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"},"example":{"ok":true,"version":"1","data":{"isc":{"infocon":"green"},"phishing":{"online":43298},"botnetC2":{"total":5,"byCountry":{"US":2}}}}}}},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/api/v1/news":{"get":{"summary":"Latest security headlines (links to the publisher)","operationId":"news","parameters":[{"name":"cat","in":"query","required":false,"description":"News category","schema":{"type":"string","enum":["breaking","vulns","breaches","outages","gov","intel"]}},{"name":"limit","in":"query","required":false,"description":"Max items (1-200)","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"},"example":{"ok":true,"version":"1","data":[{"id":"a1b2c3d4","title":"Example headline","url":"https://publisher.example/story","source":"Publisher","category":"vulns","cves":[],"kev":false}]}}}},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/api/v1/breaches":{"get":{"summary":"Have I Been Pwned breach totals and newest breaches (organisation level only)","operationId":"breaches","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"},"example":{"ok":true,"version":"1","data":{"breaches":1054,"accounts":17862709990}}}}},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/api/v1/internet":{"get":{"summary":"Certificate Transparency volume, BGP table size, OSV advisory activity","operationId":"internet","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"},"example":{"ok":true,"version":"1","data":{"ct":{"logs":15,"entries":31180212928},"bgp":{"v4":1170724}}}}}},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/api/v1/daily":{"get":{"summary":"Daily snapshot cards (last 30 days)","operationId":"daily","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"},"example":{"ok":true,"version":"1","data":[{"day":"2026-11-20","card":"https://www.chyp.ai/card/daily/2026-11-20.svg"}]}}}},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/api/v1/sources":{"get":{"summary":"Every data source with licence, cadence, status and last pull","operationId":"sources","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"},"example":{"ok":true,"version":"1","data":[{"id":"kev","name":"CISA KEV","licence":"Public domain","status":"live"}]}}}},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/api/v1/last-resort":{"get":{"summary":"The Last Resort: aggregate, unverified statistics from researchers' stalled disclosure cases (owner-approved cases only; organizations named only with 3+ independent reports)","operationId":"last_resort","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"},"example":{"ok":true,"version":"1","data":{"approvedCases":0,"awaitingReview":0,"rates":{"respondedPct":null},"bySector":[],"byProgram":[],"byClass":[],"trend":[{"month":"2026-11","reported":0,"received":0}],"named":[]}}}}},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/api/v1/openapi.json":{"get":{"summary":"OpenAPI 3.1 description of this API","operationId":"openapi_json","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"304":{"description":"Not modified (ETag)"},"400":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}}},"components":{"schemas":{"Envelope":{"type":"object","required":["ok","version","data"],"properties":{"ok":{"type":"boolean"},"version":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"},"data":{},"attribution":{"type":"string"}}},"Error":{"type":"object","properties":{"ok":{"const":false},"version":{"type":"string"},"error":{"type":"object","properties":{"status":{"type":"integer"},"code":{"type":"string"},"message":{"type":"string"}}}}}},"responses":{"Error":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}