{"components":{"responses":{"Error":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Error"}},"schemas":{"Envelope":{"properties":{"data":{},"meta":{"properties":{"notice":{"type":"string"}},"type":"object"}},"type":"object"},"Error":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"type":"object"}},"type":"object"}},"securitySchemes":{"ApiKey":{"in":"header","name":"X-Api-Key","type":"apiKey"},"Bearer":{"scheme":"bearer","type":"http"}}},"info":{"description":"Ransomware leak-site listings, groups, exposure checks and monthly statistics for integration into your own tools. A paid option on a license key. Listings are claims published by criminal groups on their own leak sites. They are not confirmed breaches. Counts describe leak-site activity, not the true number of incidents.","title":"Ransomware Tracker by ExposureDrift customer API","version":"2.0.0"},"openapi":"3.0.3","paths":{"/check":{"get":{"description":"Exact matches are counted; possible matches are listed apart.","parameters":[{"description":"Domain, e.g. acme.com.","in":"query","name":"domain","required":false,"schema":{"type":"string"}},{"description":"Company name.","in":"query","name":"company","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"Success"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"security":[{"ApiKey":[]},{"Bearer":[]}],"summary":"Has a domain or company been named?"}},"/groups":{"get":{"description":"Ransomware groups by listing count.","parameters":[{"description":"Name contains.","in":"query","name":"q","required":false,"schema":{"type":"string"}},{"description":"1 for groups active in the last 90 days.","in":"query","name":"active","required":false,"schema":{"type":"string"}},{"description":"ransomware (default) or all.","in":"query","name":"kind","required":false,"schema":{"type":"string"}},{"description":"Page size.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Offset.","in":"query","name":"offset","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"Success"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"security":[{"ApiKey":[]},{"Bearer":[]}],"summary":"List groups"}},"/groups/{slug}":{"get":{"description":"Counts, sectors, countries, leak sites with addresses and cited public reporting.","parameters":[{"description":"Group slug.","in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"Success"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"security":[{"ApiKey":[]},{"Bearer":[]}],"summary":"One group"}},"/listings":{"get":{"description":"Newest stored first. For sync use order=asc and keep next_cursor.","parameters":[{"description":"Only listings first seen at or after this time (2026-11-01 or 2026-11-01T08:00:00Z).","in":"query","name":"since","required":false,"schema":{"type":"string"}},{"description":"Only listings first seen before this time.","in":"query","name":"until","required":false,"schema":{"type":"string"}},{"description":"Group slug or name (exact).","in":"query","name":"group","required":false,"schema":{"type":"string"}},{"description":"Sector slug, e.g. healthcare.","in":"query","name":"sector","required":false,"schema":{"type":"string"}},{"description":"Two-letter country code.","in":"query","name":"country","required":false,"schema":{"type":"string"}},{"description":"Organization name or domain contains.","in":"query","name":"q","required":false,"schema":{"type":"string"}},{"description":"Claimed data type, e.g. financial.","in":"query","name":"tag","required":false,"schema":{"type":"string"}},{"description":"desc (default) or asc.","in":"query","name":"order","required":false,"schema":{"type":"string"}},{"description":"next_cursor from the previous response.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"Page size (plan maximum applies).","in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"Success"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"security":[{"ApiKey":[]},{"Bearer":[]}],"summary":"List listings"}},"/listings/{id}":{"get":{"description":"Adds the claim text, the group's own post address and the capture when one exists.","parameters":[{"description":"Listing id.","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"Success"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"security":[{"ApiKey":[]},{"Bearer":[]}],"summary":"One listing"}},"/me":{"get":{"description":"Counts as one call.","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"Success"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"security":[{"ApiKey":[]},{"Bearer":[]}],"summary":"Your key, plan, limits and today's usage"}},"/portfolio/alerts":{"get":{"description":"A new listing that names one of your suppliers. order=asc with a cursor to sync.","parameters":[{"description":"desc (default) or asc.","in":"query","name":"order","required":false,"schema":{"type":"string"}},{"description":"next_cursor from the previous response.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"Page size.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"Success"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"security":[{"ApiKey":[]},{"Bearer":[]}],"summary":"Alerts for your suppliers"}},"/portfolio/vendors":{"get":{"description":"Each with where it stands today. Named suppliers first.","parameters":[{"description":"Page size.","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Offset.","in":"query","name":"offset","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"Success"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"security":[{"ApiKey":[]},{"Bearer":[]}],"summary":"List your saved suppliers"},"post":{"description":"Up to your plan's supplier limit. A supplier already named is shown as named but does not alert; only new listings do.","requestBody":{"content":{"application/json":{"schema":{"properties":{"vendors":{"items":{"properties":{"domain":{"type":"string"},"name":{"type":"string"},"note":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"}}},"required":true},"responses":{"200":{"description":"Counts: added, duplicates, invalid, over_cap"}},"security":[{"ApiKey":[]},{"Bearer":[]}],"summary":"Add suppliers"}},"/portfolio/vendors/{id}":{"delete":{"parameters":[{"description":"Supplier id.","in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Removed"},"404":{"$ref":"#/components/responses/Error"}},"security":[{"ApiKey":[]},{"Bearer":[]}],"summary":"Remove a supplier"}},"/portfolio/webhook":{"delete":{"responses":{"200":{"description":"Off"}},"security":[{"ApiKey":[]},{"Bearer":[]}],"summary":"Switch the webhook off"},"get":{"description":"Address, whether it is on, consecutive failures.","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"Success"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"security":[{"ApiKey":[]},{"Bearer":[]}],"summary":"Your webhook settings"},"put":{"description":"https only, a public host name. The signing secret is returned once, in the response that creates it.","requestBody":{"content":{"application/json":{"schema":{"properties":{"url":{"type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"description":"Saved"},"400":{"$ref":"#/components/responses/Error"}},"security":[{"ApiKey":[]},{"Bearer":[]}],"summary":"Set and switch on the webhook"}},"/portfolio/webhook/rotate-secret":{"post":{"responses":{"200":{"description":"The new secret, shown once"}},"security":[{"ApiKey":[]},{"Bearer":[]}],"summary":"Create a new signing secret"}},"/portfolio/webhook/test":{"post":{"responses":{"200":{"description":"Whether it arrived"}},"security":[{"ApiKey":[]},{"Bearer":[]}],"summary":"Send a test event"}},"/stats/monthly":{"get":{"description":"Totals, change, top groups, sectors and countries for one month.","parameters":[{"description":"2026-10","in":"query","name":"month","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"Success"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"security":[{"ApiKey":[]},{"Bearer":[]}],"summary":"Monthly statistics"}},"/stats/sectors/{slug}":{"get":{"description":"Twelve-month view of one sector.","parameters":[{"description":"Sector slug.","in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"Success"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"security":[{"ApiKey":[]},{"Bearer":[]}],"summary":"Sector statistics"}},"/usage":{"get":{"description":"Calls per day against the daily limit.","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"Success"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}},"security":[{"ApiKey":[]},{"Bearer":[]}],"summary":"Your usage for 30 days"}},"/vendors/check":{"post":{"description":"Up to your plan's vendor limit per call.","requestBody":{"content":{"application/json":{"schema":{"properties":{"vendors":{"items":{"properties":{"domain":{"type":"string"},"name":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"}}},"required":true},"responses":{"200":{"description":"Success"},"400":{"$ref":"#/components/responses/Error"}},"security":[{"ApiKey":[]},{"Bearer":[]}],"summary":"Check a vendor list"}}},"servers":[{"url":"/api/v2"}],"x-plan-limits":{"enterprise":{"daily":100000,"page_max":500,"per_minute":300,"vendors":500},"pro":{"daily":1000,"page_max":100,"per_minute":60,"vendors":100},"team":{"daily":10000,"page_max":200,"per_minute":120,"vendors":250}}}
