Ransomware.live icon

Ransomware.live

Interact with the ransomware.live API

Actions16

Overview

This node interacts with the ransomware.live API to list 8-K filings, which are reports companies must file with the SEC to announce major events that shareholders should know about. The "List Filings" operation under the "8-K Filing" resource allows users to retrieve filtered lists of these filings based on criteria such as stock ticker, CIK code, filing year and month, and specific item inclusions.

Common scenarios for this node include:

  • Monitoring recent or historical 8-K filings for a particular company by its ticker symbol or CIK.
  • Filtering filings by date to analyze trends or events within a specific timeframe.
  • Including or excluding certain types of filings (Item 1.05 or Item 8.01) to focus on relevant disclosures.

Practical example: A financial analyst could use this node to automatically fetch all 8-K filings for Microsoft (ticker MSFT) from June 2023, including only filings related to Item 1.05 disclosures, to track significant corporate events.

Properties

Name Meaning
Ticker Filter filings by stock ticker symbol (e.g., MSFT).
CIK Filter filings by Central Index Key (CIK) code (e.g., 0001234567).
Year Filter filings by 4-digit year of the filing date (e.g., 2025).
Month Filter filings by 2-digit month of the filing date (e.g., 06).
Include Item 1.05 Boolean flag to include or exclude Item 1.05 filings (true to include, false to exclude).
Include Item 8.01 Boolean flag to include or exclude Item 8.01 filings (true to include, false to exclude).

Output

The output is an array of JSON objects representing the 8-K filings matching the specified filters. Each object corresponds to a single filing and contains details as returned by the ransomware.live API's /8k endpoint.

If multiple items are returned, they are flattened into the output array. If a single object is returned, it is wrapped in a JSON object. If no data is returned, the output will indicate success without data.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for the ransomware.live API.
  • The node uses the base URL https://api-pro.ransomware.live unless overridden by credentials.
  • Proper configuration of the API authentication credential in n8n is necessary.

Troubleshooting

  • Unsupported Operation Error: If an operation other than "list" is selected for the "8-K Filing" resource, the node will throw an error indicating unsupported operation. Ensure the operation is set to "list".
  • Invalid Parameter Values: Providing invalid ticker symbols, CIK codes, or improperly formatted year/month values may result in empty responses or API errors.
  • API Authentication Errors: Missing or incorrect API credentials will cause authentication failures. Verify the API key credential is correctly configured.
  • Empty Results: If no filings match the filter criteria, the output will be empty. Try broadening filters or verifying input parameters.

Links and References

Discussion