> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wokelo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# M&A Activity

## 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

**Authorization** `string` *required*

JWT token obtained from the Authentication request

### Body Parameters

**topic** `string` *required*

Industry topic to surface M\&A transactions for (e.g. `"HVAC in US"`)

**workflow** `string` *required*

The workflow to run. Must be `"acquisition_workflow"` for M\&A Activity.

**workbook\_name** `string` *required*

Name of the workbook that will hold the generated report (e.g. `"HVAC in US"`)

**advanced\_settings** `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

**transaction\_date** `object`

Filter by the date of the transaction. Dates use the `YYYY-MM-DD` format.

**from** `string`

Earliest transaction date (inclusive), e.g. `"2023-10-28"`

**to** `string`

Latest transaction date (inclusive), e.g. `"2026-10-29"`

**transaction\_status** `string[]`

Filter by the status of the transaction. Pass an empty array to include all statuses.

Supported array values: `"completed"`, `"announced"`

**transaction\_amount** `object`

Filter by transaction amount (in million USD).

**from** `number`

Minimum transaction amount, e.g. `10`

**to** `number`

Maximum transaction amount, e.g. `500`

**transaction\_amount\_include\_blanks** `boolean`

When `true`, transactions with no disclosed amount are included in the results alongside transactions that match the `transaction_amount` range.

#### Target company filters

**company\_type** `string`

Type of company to include. Accepted values: `"private"`, `"public"`, `"all"`

**geography** `string[]`

Geographic scope. Pass `["Worldwide"]` for no geographic restriction, or a list of ISO country codes (e.g. `["USA", "GBR"]`).

**founded\_year** `object`

Filter by company founding year.

**from** `integer`

Minimum founding year (inclusive), e.g. `2010`

**to** `integer`

Maximum founding year (inclusive), e.g. `2020`

**employee\_count** `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+`

**total\_funding** `object`

Filter by total funding amount raised (in million USD).

**from** `number`

Minimum total funding, e.g. `1`

**to** `number`

Maximum total funding, e.g. `50`

**total\_funding\_include\_blanks** `boolean`

When `true`, companies with no reported total funding are included in the results alongside companies that match the `total_funding` range.

**funding\_stage** `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`

```json Basic request theme={"system"}
{
  "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
  }
}
```

```json Request with filters theme={"system"}
{
  "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 a `report_id` that identifies the M\&A Activity report.

#### Successful Response Fields

**report\_id** `integer`

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

```json 200 theme={"system"}
{
  "report_id": 123345
}
```

## 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.