> For the complete documentation index, see [llms.txt](https://docs.intellizence.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.intellizence.com/signals-api/mergers-and-acquisitions/sample-requests.md).

# Intellizence Mergers & Acquisitions (M\&A) API Sample Requests

Use these sample API requests to retrieve mergers, acquisitions, divestments, and related transaction records from the Intellizence Mergers and Acquisitions API.

These examples show common ways to filter M\&A records by date, company, industry, geography, deal status, deal type, and deal value.

{% hint style="info" %}
All request parameters are optional. You can use a single filter or combine multiple filters based on your use case.
{% endhint %}

***

### Endpoint

```http
POST https://connect.intellizence.com/api/dataset/mna
```

### Authentication

Include your API key in the request header.

```http
x-api-key: YOUR_API_KEY
```

### Content Type

```http
Content-Type: application/json
```

***

## M\&A API Sample API Requests

### 1. Get Daily Updated Records

Use `dateType: "LAST-MODIFIED"` to retrieve records that were created or updated on a specific date.

This is recommended for daily syncs, alerts, enrichment workflows, and automated data pipelines.

#### Request Body

```json
{
  "dateType": "LAST-MODIFIED",
  "date": "2025-02-24",
  "limit": 5
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/dataset/mna \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "dateType": "LAST-MODIFIED",
    "date": "2025-02-24",
    "limit": 5
  }'
```

***

### 2. Get Deals Announced on a Specific Date

Use `dateType: "ANNOUNCED"` and `date` to retrieve M\&A deals announced on a specific date.

#### Request Body

```json
{
  "dateType": "ANNOUNCED",
  "date": "2025-02-24",
  "limit": 10
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/dataset/mna \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "dateType": "ANNOUNCED",
    "date": "2025-02-24",
    "limit": 10
  }'
```

***

### 3. Get Deals Announced Within a Date Range

Use `startDate` and `endDate` to retrieve deals announced during a specific period.

#### Request Body

```json
{
  "dateType": "ANNOUNCED",
  "startDate": "2025-02-01",
  "endDate": "2025-02-28",
  "limit": 25
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/dataset/mna \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "dateType": "ANNOUNCED",
    "startDate": "2025-02-01",
    "endDate": "2025-02-28",
    "limit": 25
  }'
```

***

### 4. Search by Acquiring Company

Use `acquiringCompanyName` to find deals involving a specific acquirer.

This is useful for tracking acquisition activity by strategic buyers, private equity firms, investment firms, and large corporations.

#### Request Body

```json
{
  "acquiringCompanyName": "Blackstone",
  "limit": 10
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/dataset/mna \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "acquiringCompanyName": "Blackstone",
    "limit": 10
  }'
```

***

### 5. Search by Acquired Company

Use `acquiredCompanyName` to find deals involving a specific target or acquired company.

#### Request Body

```json
{
  "acquiredCompanyName": "VMware",
  "limit": 10
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/dataset/mna \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "acquiredCompanyName": "VMware",
    "limit": 10
  }'
```

***

### 6. Search by Industry

Use industry filters to retrieve deals where the acquiring or acquired company belongs to one or more industries.

This is useful for sector research, market mapping, investment analysis, and competitive intelligence.

#### Request Body

```json
{
  "acquiredCompanyIndustry": [
    "technology",
    "financial services"
  ],
  "limit": 20
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/dataset/mna \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "acquiredCompanyIndustry": [
      "technology",
      "financial services"
    ],
    "limit": 20
  }'
```

***

### 7. Search by Company Location

Use company location filters to find deals involving companies headquartered in a specific country, state, province, city, or region.

#### Request Body

```json
{
  "acquiredCompanyLocation": "United States of America",
  "limit": 20
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/dataset/mna \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "acquiredCompanyLocation": "United States of America",
    "limit": 20
  }'
```

***

### 8. Search by Deal Status

Use `mnaStatus` to filter deals by status such as announced, completed, pending, or terminated.

#### Request Body

```json
{
  "mnaStatus": "Announced",
  "limit": 20
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/dataset/mna \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "mnaStatus": "Announced",
    "limit": 20
  }'
```

***

### 9. Search by Deal Value

Use `dealAmount` to filter deals by transaction value.

You can use comparison operators such as `>`, `>=`, `<`, `<=`, `=`, and `!=`.

When filtering by deal amount, include `currency` for more precise results.

#### Request Body

```json
{
  "dealAmount": ">1000000000",
  "currency": "USD",
  "limit": 20
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/dataset/mna \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "dealAmount": ">1000000000",
    "currency": "USD",
    "limit": 20
  }'
```

***

### 10. Use Multiple Filters Together

Combine filters to narrow results by date range, industry, company type, deal value, currency, and deal status.

#### Request Body

```json
{
  "dateType": "ANNOUNCED",
  "startDate": "2025-01-01",
  "endDate": "2025-03-31",
  "acquiredCompanyIndustry": [
    "technology"
  ],
  "acquiringCompanyType": [
    "Public"
  ],
  "mnaStatus": "Announced",
  "dealAmount": ">500000000",
  "currency": "USD",
  "limit": 50
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/dataset/mna \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "dateType": "ANNOUNCED",
    "startDate": "2025-01-01",
    "endDate": "2025-03-31",
    "acquiredCompanyIndustry": [
      "technology"
    ],
    "acquiringCompanyType": [
      "Public"
    ],
    "mnaStatus": "Announced",
    "dealAmount": ">500000000",
    "currency": "USD",
    "limit": 50
  }'
```

***

## Use Case Examples

### 1. Daily Data Sync

Use this example when you want to pull newly added or updated M\&A records into your application, database, CRM, or analytics workflow.

#### Recommended Filters

```json
{
  "dateType": "LAST-MODIFIED",
  "date": "2025-02-24",
  "limit": 100
}
```

#### Best For

* Data pipelines
* Daily refreshes
* Internal dashboards
* Alerts and workflow automation
* CRM and data warehouse enrichment

***

### 2. CRM or Account Enrichment

Use this example to check whether a company in your CRM has recent M\&A activity.

#### Recommended Filters

```json
{
  "acquiringCompanyDomain": "salesforce.com",
  "dateType": "LAST-MODIFIED",
  "startDate": "2025-01-01",
  "endDate": "2025-03-31",
  "limit": 10
}
```

#### Best For

* CRM enrichment
* Account scoring
* Sales intelligence
* Customer intelligence
* Signal-based selling workflows

***

### 3. Investment Research

Use this example to track large transactions in a specific sector.

#### Recommended Filters

```json
{
  "dateType": "ANNOUNCED",
  "startDate": "2025-01-01",
  "endDate": "2025-12-31",
  "acquiredCompanyIndustry": [
    "healthcare"
  ],
  "dealAmount": ">1000000000",
  "currency": "USD",
  "limit": 50
}
```

#### Best For

* Market mapping
* Sector research
* Deal trend analysis
* Event-driven investing
* Private equity and corporate development research

***

### 4. Competitive Intelligence

Use this example to monitor acquisition activity in a specific industry or geography.

#### Recommended Filters

```json
{
  "dateType": "ANNOUNCED",
  "startDate": "2025-01-01",
  "endDate": "2025-03-31",
  "acquiredCompanyIndustry": [
    "software"
  ],
  "acquiredCompanyLocation": "United States of America",
  "limit": 25
}
```

#### Best For

* Competitor tracking
* Market consolidation analysis
* Industry monitoring
* Strategic planning
* Product and market research

***

### 5. Sales and Account Monitoring

Use this example to identify companies going through ownership changes, integration activity, vendor reassessment, or strategic transformation.

#### Recommended Filters

```json
{
  "dateType": "LAST-MODIFIED",
  "startDate": "2025-01-01",
  "endDate": "2025-03-31",
  "acquiredCompanyIndustry": [
    "software"
  ],
  "mnaStatus": "Announced",
  "limit": 25
}
```

#### Best For

* Prospecting
* Account prioritization
* Trigger-based outreach
* Customer risk monitoring
* Expansion and cross-sell opportunities

***

## Recommended Use Cases

| Use Case                     | Recommended Filters                                        |
| ---------------------------- | ---------------------------------------------------------- |
| Daily data sync              | `dateType`, `date`, `limit`                                |
| CRM enrichment               | company domain filters, `dateType`, `startDate`, `endDate` |
| Investment research          | industry, date range, deal value, currency                 |
| Competitive intelligence     | industry, geography, announced date                        |
| Sales and account monitoring | industry, status, last modified date                       |

***

## Best Practices

### Use `LAST-MODIFIED` for daily syncs

For recurring syncs, alerts, and automated workflows, use `LAST-MODIFIED`.

```json
{
  "dateType": "LAST-MODIFIED",
  "date": "2025-02-24"
}
```

This helps retrieve records that were newly added or updated on that date.

### Use `ANNOUNCED` for event-date research

For research based on when a deal was announced, use `ANNOUNCED`.

```json
{
  "dateType": "ANNOUNCED",
  "startDate": "2025-01-01",
  "endDate": "2025-03-31"
}
```

### Use `limit` to control result size

The default limit is `100` records if no limit is provided.

```json
{
  "limit": 100
}
```

### Combine filters for more precise results

You can combine multiple filters in a single request to narrow your results.

```json
{
  "dateType": "ANNOUNCED",
  "startDate": "2025-01-01",
  "endDate": "2025-03-31",
  "acquiredCompanyIndustry": [
    "technology"
  ],
  "mnaStatus": "Announced",
  "dealAmount": ">500000000",
  "currency": "USD",
  "limit": 50
}
```

***

## Notes

* All parameters are optional.
* Dates should be provided in `YYYY-MM-DD` format.
* Use `LAST-MODIFIED` when you want newly added or updated records.
* Use `ANNOUNCED` when you want records based on the deal announcement date.
* Include `currency` when filtering by `dealAmount`.
* Use company domain filters for CRM matching, account enrichment, and workflow automation.
* Use industry and geography filters for market research, competitive intelligence, and investment analysis.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.intellizence.com/signals-api/mergers-and-acquisitions/sample-requests.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.