---
title: "M&A & Transactions Layer API"
url: "https://developer.argaam.com/apis/ma-transactions-layer-api-production-v1/versions/b96972fa-b9a4-4989-9c25-cdd3473fab7f"
---

# M&A & Transactions Layer API

OpenAPI specification document.

```json
{"openapi":"3.0.1","info":{"title":"M&A & Transactions Layer API","description":"Mergers and acquisitions across the market: M&A deals at the company and market level, with full individual deal records.","contact":{"name":"Argaam IT","url":"https://www.argaam.com","email":"developer@argaam.com"},"version":"v1.1"},"paths":{"/api/v1.1/companies/{stockSymbol}/mergers-acquisitions":{"get":{"tags":["Companies"],"parameters":[{"name":"stockSymbol","in":"path","required":true,"schema":{"type":"string"},"example":"2222","description":"Tadawul stock symbol of the company, e.g. `2222` (Saudi Aramco)."}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiV1Response"}}}}},"summary":"Get M&A deals for a company","description":"Returns the M&A deals for the company identified by `stockSymbol`.","operationId":"getCompaniesByStockSymbolMergersAcquisitions"}},"/api/v1.1/markets/{marketId}/mergers-acquisitions":{"get":{"tags":["Markets"],"parameters":[{"name":"marketId","in":"path","required":true,"schema":{"type":"integer","format":"int32"},"description":"Market ID (e.g. `1` for Saudi Tadawul).","example":3}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiV1Response"}}}}},"summary":"Get mergers and acquisitions deals for a market.","description":"Returns a list of M&A transactions announced or completed by companies\r\nin the specified market, sorted newest-first.\r\n            \r\nEach deal record includes:\r\n- Acquirer and target company names (Arabic + English)\r\n- Deal type (Acquisition, Merger, Stake purchase, Divestiture)\r\n- Transaction value in SAR (where disclosed)\r\n- Announcement and completion dates\r\n               \r\n**Tip:** For the full deal record (description, closing conditions) use\r\n`GET /markets/mergers-acquisitions/{dealId}`.\r\nFor M&A activity specific to one company use\r\n`GET /companies/{companyId}/mergers-acquisitions`.","operationId":"getMarketsByMarketIdMergersAcquisitions"}},"/api/v1.1/markets/mergers-acquisitions/{dealId}":{"get":{"tags":["Markets"],"parameters":[{"name":"dealId","in":"path","required":true,"schema":{"type":"integer","format":"int32"},"description":"Unique numeric M&A deal identifier (e.g. `101`)."}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiV1Response"}}}}},"summary":"Get the full details of a specific M&A deal.","description":"Returns the complete record for a single merger or acquisition deal,\r\nincluding a narrative description, financial terms, deal status, and\r\nall key dates (announcement, signing, regulatory clearance, completion).\r\n                      \r\nReturns `404` when the requested `dealId` is not found.\r\n            \r\n**Tip:** Obtain `dealId` values from\r\n`GET /markets/{marketId}/mergers-acquisitions` or\r\n`GET /companies/{companyId}/mergers-acquisitions`.","operationId":"getMarketsMergersAcquisitionsByDealId"}}},"components":{"schemas":{"ApiV1Meta":{"type":"object","properties":{"page":{"type":"integer","format":"int32"},"pageSize":{"type":"integer","format":"int32"},"totalRecords":{"type":"integer","format":"int32"},"totalPages":{"type":"integer","format":"int32","readOnly":true},"hasNextPage":{"type":"boolean","readOnly":true},"hasPreviousPage":{"type":"boolean","readOnly":true}},"additionalProperties":false},"ApiV1RateLimit":{"type":"object","properties":{"limit":{"type":"integer","format":"int32"},"remaining":{"type":"integer","format":"int32"},"reset":{"type":"string","format":"date-time"}},"additionalProperties":false},"ApiV1Response":{"type":"object","properties":{"success":{"type":"boolean"},"apiVersion":{"type":"string","nullable":true},"timestamp":{"type":"string","format":"date-time"},"requestId":{"type":"string","nullable":true},"data":{"nullable":true},"meta":{"$ref":"#/components/schemas/ApiV1Meta"},"rateLimit":{"$ref":"#/components/schemas/ApiV1RateLimit"}},"additionalProperties":false}},"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"apikey"},"ApiKeyAuthQuery":{"type":"apiKey","in":"query","name":"apikey"}}},"security":[{"ApiKeyAuth":[]}],"servers":[{"url":"https://api.argaam.com","description":"Argaam API Gateway (Production)"}]}
```