{
"topic": "HVAC in US",
"workflow": "acquisition_workflow",
"workbook_name": "HVAC in US",
"advanced_settings": {
"company_type": "all",
"geography": ["Worldwide"],
"funding_stage": [],
"employee_count": [],
"total_funding_include_blanks": true,
"transaction_date": {
"from": "2023-10-28",
"to": "2026-10-29"
},
"transaction_status": [],
"transaction_amount_include_blanks": true
}
}
{
"topic": "HVAC in US",
"workflow": "acquisition_workflow",
"workbook_name": "HVAC in US",
"advanced_settings": {
"company_type": "private",
"geography": ["USA"],
"founded_year": {
"from": 2000,
"to": 2020
},
"funding_stage": ["Private equity round"],
"employee_count": ["51-100", "101-250"],
"total_funding": {
"from": 1,
"to": 50
},
"total_funding_include_blanks": false,
"transaction_date": {
"from": "2024-01-01",
"to": "2026-10-29"
},
"transaction_status": ["completed"],
"transaction_amount": {
"from": 10,
"to": 500
},
"transaction_amount_include_blanks": false
}
}
{
"report_id": 123345
}
Discovery
M&A Activity
POST
/
api
/
workflow_manager
/
start
/
{
"topic": "HVAC in US",
"workflow": "acquisition_workflow",
"workbook_name": "HVAC in US",
"advanced_settings": {
"company_type": "all",
"geography": ["Worldwide"],
"funding_stage": [],
"employee_count": [],
"total_funding_include_blanks": true,
"transaction_date": {
"from": "2023-10-28",
"to": "2026-10-29"
},
"transaction_status": [],
"transaction_amount_include_blanks": true
}
}
{
"topic": "HVAC in US",
"workflow": "acquisition_workflow",
"workbook_name": "HVAC in US",
"advanced_settings": {
"company_type": "private",
"geography": ["USA"],
"founded_year": {
"from": 2000,
"to": 2020
},
"funding_stage": ["Private equity round"],
"employee_count": ["51-100", "101-250"],
"total_funding": {
"from": 1,
"to": 50
},
"total_funding_include_blanks": false,
"transaction_date": {
"from": "2024-01-01",
"to": "2026-10-29"
},
"transaction_status": ["completed"],
"transaction_amount": {
"from": 10,
"to": 500
},
"transaction_amount_include_blanks": false
}
}
{
"report_id": 123345
}
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. Setworkflow 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
Body Parameters
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
Filter by the status of the transaction. Pass an empty array to include all statuses.Supported array values:
"completed", "announced"When
true, transactions with no disclosed amount are included in the results alongside transactions that match the transaction_amount range.Target company filters
Geographic scope. Pass
["Worldwide"] for no geographic restriction, or a list of ISO country codes (e.g. ["USA", "GBR"]).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+When
true, companies with no reported total funding are included in the results alongside companies that match the total_funding range.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{
"topic": "HVAC in US",
"workflow": "acquisition_workflow",
"workbook_name": "HVAC in US",
"advanced_settings": {
"company_type": "all",
"geography": ["Worldwide"],
"funding_stage": [],
"employee_count": [],
"total_funding_include_blanks": true,
"transaction_date": {
"from": "2023-10-28",
"to": "2026-10-29"
},
"transaction_status": [],
"transaction_amount_include_blanks": true
}
}
{
"topic": "HVAC in US",
"workflow": "acquisition_workflow",
"workbook_name": "HVAC in US",
"advanced_settings": {
"company_type": "private",
"geography": ["USA"],
"founded_year": {
"from": 2000,
"to": 2020
},
"funding_stage": ["Private equity round"],
"employee_count": ["51-100", "101-250"],
"total_funding": {
"from": 1,
"to": 50
},
"total_funding_include_blanks": false,
"transaction_date": {
"from": "2024-01-01",
"to": "2026-10-29"
},
"transaction_status": ["completed"],
"transaction_amount": {
"from": 10,
"to": 500
},
"transaction_amount_include_blanks": false
}
}
Response
A successful response returns areport_id that identifies the M&A Activity report.
Successful Response Fields
Unique identifier for the report created by this request. Use it to track completion and to download the results (see below).
{
"report_id": 123345
}
Tracking Completion and Exporting Results
M&A Activity generation is asynchronous. After you receive areport_id:
- Use
/api/assets/get_notebook_status/to track completion of the report. - Once the report is complete, use
/api/assets/download_report/to export the results.