# Merger & Acquisition Dataset API ## Submit Merger & Acquisition Dataset Request > This API endpoint allows users to access real-time and historical Mergers & Acquisition (M\&A) and Divestment deals data. Users can filter the results using parameters- \`dateType\`,\`startDate\`, \`endDate\`,\`date\`,\`acquiringCompanyName\`,\`acquiringCompanyDomain\`, \`acquiringCompanyIndustry\`,\`acquiringCompanyType\`,\`acquiringCompanyTicker\`,\`acquiredCompanyName\`,\`acquiredCompanyDomain\`,\`acquiredCompanyIndustry\`,\`acquiredCompanyLocation\`,\`acquiredCompanyType\`,\`acquiredCompanyTicker\`,\`sellingCompanyName\`,\`sellingCompanyDomain\`, \`sellingCompanyIndustry\`,\`sellingCompanyLocation\`,\`sellingCompanyType\`,\`sellingCompanyTicker\`,\`dealAmount\`, \`mnaStatus\` and \`mnaType\`. Users can limit the number of records returned using the \`limit\` parameter. All parameters are optional.The API key has to be passed in HTTP header with the name x-api-key. ```json {"openapi":"3.0.3","info":{"title":"Intellizence Mergers & Acquisitions Dataset API","version":"2.0"},"servers":[{"url":"https://api.intellizence.com/api/v2"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","name":"x-api-key","in":"header"}},"schemas":{"dataset_mna_body":{"type":"object","properties":{"dateType":{"type":"string","description":"Choose the date type used to filter records.The default value is 'Announced'.To get the daily update of records created or modified, 'LAST-MODIFIED' is recommended.","enum":["ANNOUNCED","LAST-MODIFIED"]},"startDate":{"type":"string","description":"The start date(YYYY-MM-DD) from which M&A deals data is required. The Intellizence Mergers & Acquisitions Dataset contains data beginning from 2020-01-01.","format":"date"},"endDate":{"type":"string","description":"The end date(YYYY-MM-DD) up to which M&A deals data is required.","format":"date"},"date":{"type":"string","description":"Exact date(YYYY-MM-DD) for which the M&A deals data is required.","format":"date"},"acquiringCompanyName":{"type":"string","description":"The name of the acquiring company for which the M&A deals data is required. Partial name matches are supported. Multiple values can be provided either as a comma-separated string or as an array."},"acquiringCompanyDomain":{"type":"string","description":"The website domain of the acquiring company for which the M&A deals data is required. Partial matches are supported. Multiple values can be provided either as a comma-separated string or as an array."},"acquiringCompanyIndustry":{"type":"string","description":"The industry of the acquiring companies for which M&A deals data is required. The industries are pre-defined by Intellizence and only the values listed below will be accepted. Multiple values should be provided as an array.","enum":["accounting, audit & tax","advertising & communication","agriculture, animal husbandry & forestry","angels/ venture capital/ private equity","automobile","aviation","banking","bio-technology","business services","chemicals & fertilizers","clean technology","conglomerate","consulting","consumer products","consumer services","defence","distribution","e-commerce","economic development","education","energy & utilities","engineering, procurement & construction","financial services","gambling","gaming","government","healthcare","human resources","insurance","it services & outsourcing","legal","logistics & supply chain","manufacturing","media & entertainment","medical device","metals & mining","not-for-profit/ ngo","others","pharmaceuticals","publishing","railways","real estate","regulatory","restaurants & food services","retail","security","shipping & ports","spac/blank check","sports","technology","telecommunication","textiles","tourism & hospitality","trading","transportation"]},"acquiringCompanyLocation":{"type":"string","description":"The HeadQuarters location of the acquiring companies for which M&A deals data is required. The location can be City or State/Province or Country. Multiple values can be provided either as a comma-separated string or as an array."},"acquiringCompanyType":{"type":"string","description":"The company type of the acquiring companies for which M&A deals data is required. The company types are pre-defined by Intellizence and only the values listed below will be accepted. Multiple values can be provided either as a comma-separated string or as an array.","enum":["Public","Private","Government/Regulator","Not-for-profit","Others"]},"acquiringCompanyTicker":{"type":"string","description":"The company type of the acquiring companies for which M&A deals data is required. The company types are pre-defined by Intellizence and only the values listed below will be accepted. Multiple values can be provided either as a comma-separated string or as an array."},"acquiredCompanyName":{"type":"string","description":"The name of the acquired company for which the M&A deals data is required. Partial name matches are supported. Multiple values can be provided either as a comma-separated string or as an array."},"acquiredCompanyDomain":{"type":"string","description":"The website domain of the acquired company for which the M&A deals data is required. Partial matches are supported. Multiple values can be provided either as a comma-separated string or as an array."},"acquiredCompanyIndustry":{"type":"string","description":"The industry of the acquired companies for which M&A deals data is required. The industries are pre-defined by Intellizence and only the values listed below will be accepted. Multiple values should be provided as an array.","enum":["accounting, audit & tax","advertising & communication","agriculture, animal husbandry & forestry","angels/ venture capital/ private equity","automobile","aviation","banking","bio-technology","business services","chemicals & fertilizers","clean technology","conglomerate","consulting","consumer products","consumer services","defence","distribution","e-commerce","economic development","education","energy & utilities","engineering, procurement & construction","financial services","gambling","gaming","government","healthcare","human resources","insurance","it services & outsourcing","legal","logistics & supply chain","manufacturing","media & entertainment","medical device","metals & mining","not-for-profit/ ngo","others","pharmaceuticals","publishing","railways","real estate","regulatory","restaurants & food services","retail","security","shipping & ports","spac/blank check","sports","technology","telecommunication","textiles","tourism & hospitality","trading","transportation"]},"acquiredCompanyLocation":{"type":"string","description":"The HeadQuarters location of the acquired companies for which M&A deals data is required. The location can be City or State/Province or Country. Multiple values can be provided either as a comma-separated string or as an array."},"acquiredCompanyType":{"type":"string","description":"The company type of the acquired companies for which M&A deals data is required. The company types are pre-defined by Intellizence and only the values listed below will be accepted. Multiple values can be provided either as a comma-separated string or as an array.","enum":["Public","Private","Government/Regulator","Not-for-profit","Others"]},"acquiredCompanyTicker":{"type":"string","description":"Acquired company stock ticker if it's a public company."},"sellingCompanyName":{"type":"string","description":"The name of the selling company for which the M&A deals data is required. Partial matches are supported."},"sellingCompanyDomain":{"type":"string","description":"The website domain of the selling company for which the M&A deals data is required. Partial matches are supported."},"sellingCompanyIndustry":{"type":"string","description":"The industry of the selling companies for which M&A deals data is required. The industries are pre-defined by Intellizence and only the values listed below will be accepted. Multiple values should be provided as an array.","enum":["accounting, audit & tax","advertising & communication","agriculture, animal husbandry & forestry","angels/ venture capital/ private equity","automobile","aviation","banking","bio-technology","business services","chemicals & fertilizers","clean technology","conglomerate","consulting","consumer products","consumer services","defence","distribution","e-commerce","economic development","education","energy & utilities","engineering, procurement & construction","financial services","gambling","gaming","government","healthcare","human resources","insurance","it services & outsourcing","legal","logistics & supply chain","manufacturing","media & entertainment","medical device","metals & mining","not-for-profit/ ngo","others","pharmaceuticals","publishing","railways","real estate","regulatory","restaurants & food services","retail","security","shipping & ports","spac/blank check","sports","technology","telecommunication","textiles","tourism & hospitality","trading","transportation"]},"sellingCompanyLocation":{"type":"string","description":"The HeadQuarters location of the selling companies for which M&A deals data is required. The location can be City or State/Province or Country."},"sellingCompanyType":{"type":"string","description":"The company type of the selling companies for which M&A deals data is required. The company types are pre-defined by Intellizence and only the values listed below will be accepted. Multiple values can be provided either as a comma-separated string or as an array.","enum":["Public","Private","Government/Regulator","Not-for-profit","Others"]},"sellingCompanyTicker":{"type":"string","description":"Selling company stock ticker if it's a public company."},"mnaStatus":{"type":"string","description":"Filter M&A deals data based on M&A status. The common status are Announced, Completed and Terminated.","enum":["Announced","Completed","Terminated","Rumours & Speculation","Bid/Offer","In Discussion/Negotiation","Shareholder Approved","Shareholder Rejected","Board Rejected","Regulator Review","Regulator Approved","Regulator Rejected","Legal Dispute"]},"mnaType":{"type":"string","description":"Filter M&A deals data by M&A Type.","enum":["Acquisition - Total","Acquisition - Asset / Business Division Sale","Acquisition - Financial Stake","Acquisition - Joint Venture Stake","Merger","Merger - Business Operations","Merger - Internal Operations/Subsidiaries","Reverse Takeover","Tender Offer","Acqui-hire","Other"]},"dealAmount":{"pattern":"^(>|>=|<|<=|=|!=)?\\d+(,\\d+)?$","type":"number","description":"Filter the M&A deals data by deal amount. Pass the `currency` whenver `dealAmount` is used. If `currency` is not provided along with `dealAmount`, all the deals data that matches the deal amount of any currency will be returned. The allowed operators are >, >=, <, <=,=,!=, (MinimumValue),(Maximum Value). Examples: >1000000, >=1000000, <1000000, <=1000000,=1000000,!=1000000, 1000000,400000","format":"float"},"currency":{"type":"string","description":"The currency of the deal transaction.","enum":["USD","CAD","EUR","GBP","INR","AUD","CHF","CNY","JPY","SEK"]},"limit":{"type":"integer","description":"The maximum number of records to be returned."}}},"inline_response_200":{"type":"object","properties":{"id":{"type":"string","description":"Unique ID of the record"},"announcedDate":{"type":"string","description":"Merger/Acqusition announced date(YYYY-MM-DD).","format":"date"},"acquiringCompany":{"$ref":"#/components/schemas/inline_response_200_acquiringCompany"},"acquiredCompany":{"$ref":"#/components/schemas/inline_response_200_acquiredCompany"},"sellingCompany":{"$ref":"#/components/schemas/inline_response_200_sellingCompany"},"mnaType":{"type":"string","description":"Merger & Acquisition type"},"mnaStatus":{"type":"string","description":"Merger & Acquisition deal status"},"dealAmount":{"type":"number","description":"The deal amount if publicly disclosed","format":"float"},"currency":{"type":"string","description":"The currency of the deal transaction"},"lastModified":{"type":"string","description":"The last modified date of the record (YYYY-MM-DD)","format":"date"},"title":{"type":"string","description":"Source title - News or press release headline"},"url":{"type":"string","description":"URL of the source document."}}},"inline_response_200_acquiringCompany":{"type":"object","properties":{"name":{"type":"string","description":"Acquiring company name"},"domain":{"type":"string","description":"Acquiring company website domain"},"industries":{"type":"array","description":"The industries associated with the acquiring company.","items":{"type":"string"}},"location":{"type":"string","description":"The HQ location of the acquiring company."},"type":{"type":"string","description":"The company type of the acquiring company"},"ticker":{"type":"array","description":"The stock ticker symbol of the acquiring company (if public).","items":{"type":"string"}}}},"inline_response_200_acquiredCompany":{"type":"object","properties":{"name":{"type":"string","description":"Acquired company name"},"domain":{"type":"string","description":"Aacquired company website domain"},"industries":{"type":"array","description":"The industries associated with the acquired company.","items":{"type":"string"}},"location":{"type":"string","description":"The HQ location of the acquired company."},"type":{"type":"string","description":"The company type of the acquired company."},"ticker":{"type":"array","description":"The stock ticker symbol of the acquired company (if public).","items":{"type":"string"}}}},"inline_response_200_sellingCompany":{"type":"object","properties":{"name":{"type":"string","description":"Selling company name"},"domain":{"type":"string","description":"Selling company website domain"},"industries":{"type":"array","description":"The industries associated with the selling company.","items":{"type":"string"}},"location":{"type":"string","description":"The HQ location of the selling company."},"type":{"type":"string","description":"The company type of the selling company."},"ticker":{"type":"array","description":"The stock ticker symbol of the selling company (if public)","items":{"type":"string"}}}}}},"paths":{"/dataset/mna":{"post":{"summary":"Submit Merger & Acquisition Dataset Request","description":"This API endpoint allows users to access real-time and historical Mergers & Acquisition (M&A) and Divestment deals data. Users can filter the results using parameters- `dateType`,`startDate`, `endDate`,`date`,`acquiringCompanyName`,`acquiringCompanyDomain`, `acquiringCompanyIndustry`,`acquiringCompanyType`,`acquiringCompanyTicker`,`acquiredCompanyName`,`acquiredCompanyDomain`,`acquiredCompanyIndustry`,`acquiredCompanyLocation`,`acquiredCompanyType`,`acquiredCompanyTicker`,`sellingCompanyName`,`sellingCompanyDomain`, `sellingCompanyIndustry`,`sellingCompanyLocation`,`sellingCompanyType`,`sellingCompanyTicker`,`dealAmount`, `mnaStatus` and `mnaType`. Users can limit the number of records returned using the `limit` parameter. All parameters are optional.The API key has to be passed in HTTP header with the name x-api-key.","operationId":"getMnaDataset","parameters":[{"name":"x-api-key","in":"header","description":"Intellizence API key for authenticating the request.","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Intellizence Mergers & Acquisitions Dataset Request Body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/dataset_mna_body"}}}},"responses":{"200":{"description":"Successful response, returns the Merger & Acquisition dataset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inline_response_200"}}}},"400":{"description":"Bad request, possibly missing required parameters, invalid data, invalid or missing API key"},"404":{"description":"Available credits are 0"},"405":{"description":"Insufficient credits"},"406":{"description":"Invalid deal amount filter format"},"500":{"description":"Internal server error"}}}}}} ``` --- # Agent Instructions: 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: ``` GET https://docs.intellizence.com/dataset-api/merger-and-acquisition.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.