{"openapi":"3.1.0","info":{"title":"RedTeamDaily public API","version":"1.0.0","description":"Security news, CVEs and entities from RedTeamDaily. Every response includes \"attribution\": \"RedTeamDaily\"; show it where you use the data. We return our own summaries and links to the original articles, never publisher text. Terms: https://redteamdaily.com/api-terms"},"servers":[{"url":"https://api.redteamdaily.com"}],"paths":{"/public/v1/stories":{"get":{"summary":"Stories, newest first. Filters: since, until, category, severity, region, cve, entity. Scope read:stories","tags":["public"],"parameters":[{"name":"since","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}(T[\\d:.]+Z)?$"}},{"name":"until","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}(T[\\d:.]+Z)?$"}},{"name":"category","in":"query","required":false,"schema":{"type":"string","maxLength":40}},{"name":"severity","in":"query","required":false,"schema":{"type":"string","enum":["info","low","medium","high","critical"]}},{"name":"region","in":"query","required":false,"schema":{"type":"string","enum":["gb","us","eu","in","np","au","ca","jp"]}},{"name":"cve","in":"query","required":false,"schema":{"type":"string","pattern":"^CVE-\\d{4}-\\d{4,}$"}},{"name":"entity","in":"query","required":false,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":200}},{"name":"limit","in":"query","required":false,"schema":{"default":25,"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"attribution":{"type":"string","const":"RedTeamDaily"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"url":{"type":"string"},"headline":{"type":"string"},"summary":{"type":["string","null"]},"summarySimple":{"type":["string","null"]},"summaryExpert":{"type":["string","null"]},"severity":{"anyOf":[{"type":"string","enum":["info","low","medium","high","critical"]},{"type":"null"}]},"category":{"type":["string","null"]},"sourceCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"cves":{"type":"array","items":{"type":"string"}},"publishedAt":{"type":["string","null"]},"updatedAt":{"type":["string","null"]}},"required":["id","url","headline","summary","summarySimple","summaryExpert","severity","category","sourceCount","cves","publishedAt","updatedAt"],"additionalProperties":false}},"nextCursor":{"type":["string","null"]}},"required":["attribution","data","nextCursor"],"additionalProperties":false}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"apiKey":[]}]}},"/public/v1/stories/{id}":{"get":{"summary":"One story: our summaries at three levels, CVEs, entities, and links to the original articles. Scope read:stories","tags":["public"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":8,"maxLength":120}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"attribution":{"type":"string","const":"RedTeamDaily"},"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"url":{"type":"string"},"headline":{"type":"string"},"summary":{"type":["string","null"]},"summarySimple":{"type":["string","null"]},"summaryExpert":{"type":["string","null"]},"severity":{"anyOf":[{"type":"string","enum":["info","low","medium","high","critical"]},{"type":"null"}]},"category":{"type":["string","null"]},"sourceCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"cves":{"type":"array","items":{"type":"string"}},"publishedAt":{"type":["string","null"]},"updatedAt":{"type":["string","null"]},"entities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string"}},"required":["id","type","name","slug","url"],"additionalProperties":false}},"sources":{"type":"array","items":{"type":"object","properties":{"outlet":{"type":["string","null"]},"url":{"type":"string"},"publishedAt":{"type":["string","null"]}},"required":["outlet","url","publishedAt"],"additionalProperties":false}}},"required":["id","url","headline","summary","summarySimple","summaryExpert","severity","category","sourceCount","cves","publishedAt","updatedAt","entities","sources"],"additionalProperties":false}},"required":["attribution","data"],"additionalProperties":false}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"apiKey":[]}]}},"/public/v1/cves":{"get":{"summary":"CVEs, newest first, with our exploited and CISA KEV data. Filters: since, exploited, kev, severity. Scope read:cves","tags":["public"],"parameters":[{"name":"since","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}(T[\\d:.]+Z)?$"}},{"name":"exploited","in":"query","required":false,"schema":{"type":"string","enum":["true","false"]}},{"name":"kev","in":"query","required":false,"schema":{"type":"string","enum":["true","false"]}},{"name":"severity","in":"query","required":false,"schema":{"type":"string","enum":["low","medium","high","critical"]}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":200}},{"name":"limit","in":"query","required":false,"schema":{"default":25,"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"attribution":{"type":"string","const":"RedTeamDaily"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"description":{"type":["string","null"]},"cvss":{"type":["number","null"]},"cvssVersion":{"type":["string","null"]},"severity":{"anyOf":[{"type":"string","enum":["info","low","medium","high","critical"]},{"type":"null"}]},"exploited":{"type":"boolean"},"kev":{"type":"object","properties":{"listed":{"type":"boolean"},"dateAdded":{"type":["string","null"]},"requiredAction":{"type":["string","null"]}},"required":["listed","dateAdded","requiredAction"],"additionalProperties":false},"patchAvailable":{"type":["boolean","null"]},"publishedAt":{"type":["string","null"]},"modifiedAt":{"type":["string","null"]}},"required":["id","url","description","cvss","cvssVersion","severity","exploited","kev","patchAvailable","publishedAt","modifiedAt"],"additionalProperties":false}},"nextCursor":{"type":["string","null"]}},"required":["attribution","data","nextCursor"],"additionalProperties":false}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"apiKey":[]}]}},"/public/v1/cves/{id}":{"get":{"summary":"One CVE: score, exploited, KEV, affected products with version ranges, and our stories about it. Scope read:cves","tags":["public"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^CVE-\\d{4}-\\d{4,}$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"attribution":{"type":"string","const":"RedTeamDaily"},"data":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"description":{"type":["string","null"]},"cvss":{"type":["number","null"]},"cvssVersion":{"type":["string","null"]},"severity":{"anyOf":[{"type":"string","enum":["info","low","medium","high","critical"]},{"type":"null"}]},"exploited":{"type":"boolean"},"kev":{"type":"object","properties":{"listed":{"type":"boolean"},"dateAdded":{"type":["string","null"]},"requiredAction":{"type":["string","null"]}},"required":["listed","dateAdded","requiredAction"],"additionalProperties":false},"patchAvailable":{"type":["boolean","null"]},"publishedAt":{"type":["string","null"]},"modifiedAt":{"type":["string","null"]},"affected":{"type":"array","items":{"type":"object","properties":{"vendor":{"type":"string"},"product":{"type":"string"},"ranges":{"type":"array","items":{"type":"object","properties":{"from":{"type":["string","null"]},"fromInclusive":{"type":"boolean"},"to":{"type":["string","null"]},"toInclusive":{"type":"boolean"},"fixedIn":{"type":["string","null"]}},"required":["from","fromInclusive","to","toInclusive","fixedIn"],"additionalProperties":false}}},"required":["vendor","product","ranges"],"additionalProperties":false}},"stories":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"url":{"type":"string"},"headline":{"type":"string"},"publishedAt":{"type":["string","null"]}},"required":["id","url","headline","publishedAt"],"additionalProperties":false}}},"required":["id","url","description","cvss","cvssVersion","severity","exploited","kev","patchAvailable","publishedAt","modifiedAt","affected","stories"],"additionalProperties":false}},"required":["attribution","data"],"additionalProperties":false}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"apiKey":[]}]}},"/public/v1/entities":{"get":{"summary":"Companies, products, threat actors, malware and people in the news, by name. Filter: type. Scope read:entities","tags":["public"],"parameters":[{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["product","company","person","threat_actor","malware"]}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":200}},{"name":"limit","in":"query","required":false,"schema":{"default":25,"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"attribution":{"type":"string","const":"RedTeamDaily"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string"}},"required":["id","type","name","slug","url"],"additionalProperties":false}},"nextCursor":{"type":["string","null"]}},"required":["attribution","data","nextCursor"],"additionalProperties":false}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"apiKey":[]}]}},"/public/v1/entities/{id}":{"get":{"summary":"One entity and its latest stories. Scope read:entities","tags":["public"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"attribution":{"type":"string","const":"RedTeamDaily"},"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string"},"stories":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"url":{"type":"string"},"headline":{"type":"string"},"publishedAt":{"type":["string","null"]}},"required":["id","url","headline","publishedAt"],"additionalProperties":false}}},"required":["id","type","name","slug","url","stories"],"additionalProperties":false}},"required":["attribution","data"],"additionalProperties":false}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"apiKey":[]}]}},"/public/v1/search":{"get":{"summary":"Full-text search of our stories, plus matching entities and a CVE ID. Scope read:stories","tags":["public"],"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":200}},{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":50}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"attribution":{"type":"string","const":"RedTeamDaily"},"data":{"type":"object","properties":{"stories":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"url":{"type":"string"},"headline":{"type":"string"},"summary":{"type":["string","null"]},"summarySimple":{"type":["string","null"]},"summaryExpert":{"type":["string","null"]},"severity":{"anyOf":[{"type":"string","enum":["info","low","medium","high","critical"]},{"type":"null"}]},"category":{"type":["string","null"]},"sourceCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"cves":{"type":"array","items":{"type":"string"}},"publishedAt":{"type":["string","null"]},"updatedAt":{"type":["string","null"]}},"required":["id","url","headline","summary","summarySimple","summaryExpert","severity","category","sourceCount","cves","publishedAt","updatedAt"],"additionalProperties":false}},"entities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string"}},"required":["id","type","name","slug","url"],"additionalProperties":false}},"cves":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"cvss":{"type":["number","null"]},"exploited":{"type":"boolean"}},"required":["id","url","cvss","exploited"],"additionalProperties":false}}},"required":["stories","entities","cves"],"additionalProperties":false}},"required":["attribution","data"],"additionalProperties":false}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"apiKey":[]}]}},"/public/v1/breach-domains":{"get":{"summary":"Signed list of company domains in recent breach news (for the browser extension). No key needed","tags":["public"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"attribution":{"type":"string","const":"RedTeamDaily"},"keyId":{"type":"string"},"payload":{"type":"string"},"signature":{"type":"string"}},"required":["attribution","keyId","payload","signature"],"additionalProperties":false}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","description":"Your key: Authorization: Bearer rtd_live_…"}},"schemas":{"Error":{"type":"object","required":["error","message"],"properties":{"error":{"type":"string"},"message":{"type":"string"},"fields":{"type":"array","items":{"type":"string"}}}}}}}