Search
K
M&A & Transactions Layer API (Sandbox)

M&A & Transactions Layer API

v1.1OAS 3.0

Mergers and acquisitions across the market: M&A deals at the company and market level, with full individual deal records.

API Base URL
  • Server 1:https://api-sandbox.argaam.com

    Argaam API Gateway (Sandbox)

Security
ApiKeyAuth (apiKey)

An API key is a token that you provide when making API calls. Include the token in a header parameter called apikey.

Example: apikey: 123

ApiKeyAuthQuery (apiKey)

An API key is a token that you provide when making API calls. Include the token in a query parameter called apikey.

Example: ?apikey=123

Additional Information
Contact Argaam IT (developer@argaam.com)

Get M&A deals for a company

Returns the M&A deals for the company identified by stockSymbol.

get
https://api-sandbox.argaam.com/api/v1.1/companies/{stockSymbol}/mergers-acquisitions

Path Parameters

stockSymbolstringrequired

Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).

Example:2222

Response

200 application/json

Success

ApiV1Response

* Additional properties are NOT allowed.
successboolean
apiVersionstring | null
timestampstring(date-time)
requestIdstring | null
data
metaobject
* Additional properties are NOT allowed.
Show Child Parameters
rateLimitobject
* Additional properties are NOT allowed.
Show Child Parameters
get/api/v1.1/companies/{stockSymbol}/mergers-acquisitions
 
200 application/json

Get mergers and acquisitions deals for a market.

Returns a list of M&A transactions announced or completed by companies
in the specified market, sorted newest-first.

Each deal record includes:

  • Acquirer and target company names (Arabic + English)
  • Deal type (Acquisition, Merger, Stake purchase, Divestiture)
  • Transaction value in SAR (where disclosed)
  • Announcement and completion dates

Tip: For the full deal record (description, closing conditions) use
GET /markets/mergers-acquisitions/{dealId}.
For M&A activity specific to one company use
GET /companies/{companyId}/mergers-acquisitions.

get
https://api-sandbox.argaam.com/api/v1.1/markets/{marketId}/mergers-acquisitions

Path Parameters

marketIdinteger(int32)required

Market ID (e.g. 1 for Saudi Tadawul).

Example:3

Response

200 application/json

Success

ApiV1Response

* Additional properties are NOT allowed.
successboolean
apiVersionstring | null
timestampstring(date-time)
requestIdstring | null
data
metaobject
* Additional properties are NOT allowed.
Show Child Parameters
rateLimitobject
* Additional properties are NOT allowed.
Show Child Parameters
get/api/v1.1/markets/{marketId}/mergers-acquisitions
 
200 application/json