M&A & Transactions Layer API (Sandbox)

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

Get the full details of a specific M&A deal.

Returns the complete record for a single merger or acquisition deal,
including a narrative description, financial terms, deal status, and
all key dates (announcement, signing, regulatory clearance, completion).

Returns 404 when the requested dealId is not found.

Tip: Obtain dealId values from
GET /markets/{marketId}/mergers-acquisitions or
GET /companies/{companyId}/mergers-acquisitions.

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

Path Parameters

dealIdinteger(int32)required

Unique numeric M&A deal identifier (e.g. 101).

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/mergers-acquisitions/{dealId}
 
200 application/json

ApiV1Meta

object
* Additional properties are NOT allowed.
pageinteger(int32)
pageSizeinteger(int32)
totalRecordsinteger(int32)
totalPagesinteger(int32)read-only
hasNextPagebooleanread-only
hasPreviousPagebooleanread-only
Example

ApiV1RateLimit

object
* Additional properties are NOT allowed.
limitinteger(int32)
remaininginteger(int32)
resetstring(date-time)
Example

ApiV1Response

object
* Additional properties are NOT allowed.
successboolean
apiVersionstring
timestampstring(date-time)
requestIdstring
data
metaobject
* Additional properties are NOT allowed.
Show Child Parameters
rateLimitobject
* Additional properties are NOT allowed.
Show Child Parameters
Example