Skip to main content
POST

Overview

The M&A Activity API surfaces the M&A transactions that have taken place in a given industry domain. You can refine the output by transaction date, transaction status, transaction amount, and by attributes of the target company such as company type, geography, founding year, employee count, funding amount, and funding stage. M&A Activity runs as a workflow. Set workflow to acquisition_workflow in the request body to start one. The request returns a report_id, which you then use to track completion and export the results.

Endpoint Details

  • Method: POST
  • Endpoint: /api/workflow_manager/start/

Authentication Requirements

  • Include a valid JWT token in your request header
  • If you don’t have a token yet, you can get one from the /auth/token/ endpoint first.

Request

Header Parameters

string
required
JWT token obtained from the Authentication request

Body Parameters

string
required
Industry topic to surface M&A transactions for (e.g. "HVAC in US")
string
required
The workflow to run. Must be "acquisition_workflow" for M&A Activity.
string
required
Name of the workbook that will hold the generated report (e.g. "HVAC in US")
object
Filter parameters object. All filters live inside advanced_settings. Include the object in every request, and send empty values ([]) for any filter you do not want to apply.

Deal filters

object
Filter by the date of the transaction. Dates use the YYYY-MM-DD format.
string
Earliest transaction date (inclusive), e.g. "2023-10-28"
string
Latest transaction date (inclusive), e.g. "2026-10-29"
string[]
Filter by the status of the transaction. Pass an empty array to include all statuses.Supported array values: "completed", "announced"
object
Filter by transaction amount (in million USD).
number
Minimum transaction amount, e.g. 10
number
Maximum transaction amount, e.g. 500
boolean
When true, transactions with no disclosed amount are included in the results alongside transactions that match the transaction_amount range.

Target company filters

string
Type of company to include. Accepted values: "private", "public", "all"
string[]
Geographic scope. Pass ["Worldwide"] for no geographic restriction, or a list of ISO country codes (e.g. ["USA", "GBR"]).
object
Filter by company founding year.
integer
Minimum founding year (inclusive), e.g. 2010
integer
Maximum founding year (inclusive), e.g. 2020
string[]
Filter by employee headcount range. Pass an empty array to include all headcounts.Supported array values: 1-10, 11-50, 51-100, 101-250, 251-500, 501-1000, 1001-5000, 5001-10000, 10000+
object
Filter by total funding amount raised (in million USD).
number
Minimum total funding, e.g. 1
number
Maximum total funding, e.g. 50
boolean
When true, companies with no reported total funding are included in the results alongside companies that match the total_funding range.
string[]
Filter by funding stage (e.g. "Series A", "Series B"). Pass an empty array to include all stages.Supported array values: Non-Equity Assistance, Angel round, Pre-seed, Seed, Series A, Series B, Series C, Series D, Series E, Series F, Series G, Series H, Series I, Series J, Corporate-Funded, Debt-Funded, Private equity round, Others

Response

A successful response returns a report_id that identifies the M&A Activity report.

Successful Response Fields

integer
Unique identifier for the report created by this request. Use it to track completion and to download the results (see below).

Tracking Completion and Exporting Results

M&A Activity generation is asynchronous. After you receive a report_id:
  1. Use /api/assets/get_notebook_status/ to track completion of the report.
  2. Once the report is complete, use /api/assets/download_report/ to export the results.