Overview

Authentication

The M&A Monitor API uses API Keys to authenticate requests. You can request key(s) from your account manager.

Keys are 32 character alpha-numeric strings and are case-sensitive. The keys are unique per user and therefore you should keep them safe and not store them in publicly accessible areas such as GitHub or in client-side code.

The API key needs to be included in the URL of each end-point as a query parameter even for POST requests.

All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail.

Overview

Response codes

We use standard HTTP response codes for success and failure notifications, and our errors are further classified by block.

In general, 40X codes are for client related failures, and 50X codes are M&A Monitor related issues. We're doing our best to diminish the latter; however, if you find consistent issues, please contact our support team: enquiries@ma-monitor.co.uk

Endpoints

Search announcements

Returns a list of all Rule 8.3 announcements that match your search criteria. The results are returned in descending order of rnsDataId. Results can be paged using the offset / limit parameters.

There are various filters that can be optionally passed to the end-point to get a list of announcements you are interested in. The filters need to be Posted to the end-point.

Parameters

companyDealtInCommonNameoptional

A filter based on the company being traded in. The name entered is checked against the Common Name of the company whose securities are the subject of the 8.3, as used by M&A Monitor to connect filings that contain slight variants of that company's name in Box 1c. The value should be a string and the results are returned where the string appears anywhere in the Common Name of the company. Note: requests with this filter present take longer to execute due to the searching requirement.

dealingCompanyCommonNameoptional

A filter based on the company initiating the trade. The name entered is checked against the Common Name of the party issuing the 8.3, as used by M&A Monitor to connect filings that contain slight variants of that company's name in Box 1a. The value should be a string and the results are returned where the string appears anywhere in the Common Name of the company. Note: requests with this filter present take longer to execute due to the searching requirement.

companyDealtInoptional

An alternative, more restricted filter based on the company being traded in. The value should be a string and the results are returned where the string appears anywhere in the name of the company as recorded in Box 1c of the filing. Note: requests with this filter present take longer to execute due to the searching requirement.

tradingCompanyoptional

An alternative, more restricted filter based on the company initiating the trade. The value should be a string and the results are returned where the string appears anywhere in the name of the company as recorded in Box 1a of the filing. Note: requests with this filter present take longer to execute due to the searching requirement.

classoptional

A filter based on the class of relevant security. The value should be one of the following options: ALL, ORDINARIES, OTHER. If this field is omitted, then results for ALL classes will be returned.

dealingDateFromoptional

A filter based on the date the trade was executed. If present, only filings for trades executed on or after this date will be returned. The value should be a date in the ISO 8601 format (YYYY-MM-DD), e.g. 2020-01-02 to specify 2nd January 2020.

dealingDateTooptional

A filter based on the date the trade was executed. If present, only filings for trades executed on or before this date will be returned. The value should be a date in the ISO 8601 format (YYYY-MM-DD), e.g. 2020-01-02 to specify 2nd January 2020.

announcementDateFromoptional

A filter based on the date the trade was announced If present, only filings for trades announced on or after this date will be returned. The value should be a date in the ISO 8601 format (YYYY-MM-DD), e.g. 2020-01-02 to specify 2nd January 2020.

announcementDateTooptional

A filter based on the date the trade was announced If present, only filings for trades announced on or before this date will be returned. The value should be a date in the ISO 8601 format (YYYY-MM-DD), e.g. 2020-01-02 to specify 2nd January 2020.

limitoptional

A limit on the number of results to be returned. Limit can range between 1 and 100, and the default is 10.

offsetoptional

An offset to the returned results to faciliate paging of large result sets. Offset can be a number greater than equal to 0, and the default is 0.

Returns

An associative array with a data property that contains an array of up to limit announcements. The totals property contains the total number of results that would be returned if there were no offset or limit parameters to aid paging.

idnumber

The unique identifier of the announcement.

companyDealtInCommonNamestring

This is the Common Name of the company whose securities are the subject of the 8.3, as used by M&A Monitor to connect filings that contain slight variants of that company's name in Box 1c

dealingCompanyCommonNamestring

This is the Common Name of the party issuing the 8.3, as used by M&A Monitor to connect filings that contain slight variants of that company's name in Box 1a

companyDealtInstring

The name of the company/stock being traded in within the announcement.

tradingCompanystring

The name of the company performing the trade

dateOfDealingstring

The date that the trade occurred in YYYY-MM-DD format. Note that this is not necessarily the date the announcement was filed.

rnsDataIdnumber

The ID of the announcement as assigned by the RNS. Note that M&A Monitor's id property should be used within all API calls.

announcementDatestring

The date that the trade was announced in a filing. The date is in a YYYY-MM-DD format.

companyDealsstring

Deal numbers assigned to M&A Database deal reports in which the company identified by the companyDealtInCommonName is recorded as a Target or Bidder at the time of the dateOfDealing. These identifiers can be subsequently passed to the /deal-details API to GET more details of the deal.

Endpoints

Basics

Includes names of parties, trading date, disclosure date and positions held.

Parameters

idrequired

An integer identifier of the announcement. This is the id that is returned from the /search API end-point.

Returns

mainDetailsobject

An object containing information about the parties involved in the trade

mainDetails.companyDealingstring

This is the name of the party issuing the 8.3 as it appears in Box 1a of the form

mainDetails.companyTypestring

An investor (Trading Company) classification assigned by M&A Monitor from the list: Bank/Stockbroker, Corporate, Family Office, Hedge Fund, Institutional Investor, Pension Fund/Nominees, Private Equity Investor, Private Investor, Sovereign Wealth Fund

mainDetails.companyDealtInstring

This is the name of the company whose securities are the subject of the 8.3 as it appears in Box 1c of the form.

mainDetails.dealingCompanyCommonNamestring

This is the Common Name of the party issuing the 8.3, as used by M&A Monitor to connect filings that contain slight variants of that company's name in Box 1a

mainDetails.companyDealtInCommonNamestring

This is the Common Name of the company whose securities are the subject of the 8.3, as used by M&A Monitor to connect filings that contain slight variants of that company's name in Box 1c

mainDetails.classOfRelevantSecuritystring

Describes the security traded /being disclosed (typically its ordinary shares, or loan notes).

mainDetails.dealingDatestring

The date the trade (s) was (were) made /or, for opening positions, the last trading day before the deal was added to the Disclosure Table.

mainDetails.totalShareCapitalstring

The number of relevant securities in issue at the Company Dealt In (this typically refers to one or other of its ordinary shares or loan notes).

mainDetails.part2aRelevantSecuritiesobject

The number of relevant securities held.

part2aRelevantSecurities.longnumber

The number of long relevant securities held from section 2a of the form.

part2aRelevantSecurities.longPercentagenumber

The percentage of the total number of relevant securities in issue represented by the issuer's long relevant securities position from section 2a of the form.

part2aRelevantSecurities.shortnumber

The number of short relevant securities held from section 2a of the form.

part2aRelevantSecurities.shortPercentagenumber

The percentage of the total number of relevant securities in issue represented by the issuer's short relevant securities position from section 2a of the form.

mainDetails.part2aDerivativesobject

The number of derivatives held.

part2aDerivatives.longnumber

The number of long derivatives held from section 2a of the form.

part2aDerivatives.longPercentagenumber

The percentage of the total number of relevant securities in issue represented by the issuer's long derivative position from section 2a of the form.

part2aDerivatives.shortnumber

The number of short derivatives held from section 2a of the form.

part2aDerivatives.shortPercentagenumber

The percentage of the total number of relevant securities in issue represented by the issuer's short derivative position from section 2a of the form.

mainDetails.part2aOptionsAndAgreementsobject

The number of options and agreements held.

part2aOptionsAndAgreements.longnumber

The number of long options held from section 2a of the form.

part2aOptionsAndAgreements.longPercentagenumber

The percentage of the total number of relevant securities in issue represented by the issuer's long options position from section 2a of the form.

part2aOptionsAndAgreements.shortnumber

The number of short options held from section 2a of the form.

part2aOptionsAndAgreements.shortPercentagenumber

The percentage of the total number of relevant securities in issue represented by the issuer's short options position from section 2a of the form.

mainDetails.part2aTotalobject

The number of relevant securities, derivatives and options held.

part2aTotal.longnumber

The aggregate of the issuer's long holdings of relevant securities, derivatives and options from section 2a of the form.

part2aTotal.longPercentagenumber

Issuer's total long position as a percentage of relevant securities in issue from section 2a of the form.

part2aTotal.shortnumber

The aggregate of the issuer's short holdings of relevant securities, derivatives and options from section 2a of the form.

part2aTotal.shortPercentagenumber

Issuer's total short position as a percentage of relevant securities in issue from section 2a of the form.

mainDetails.part2bRelevantSecuritiesobject

Describes a second security traded/being disclosed.

part2bRelevantSecurities.longnumber

For a second security, the number of long relevant securities held from section 2b of the form.

part2bRelevantSecurities.longPercentagenumber

For a second security, the percentage of the total number of relevant securities in issue represented by the issuer's long relevant securities position from section 2b of the form.

part2bRelevantSecurities.shortnumber

For a second security, the number of short relevant securities held from section 2b of the form.

part2bRelevantSecurities.shortPercentagenumber

For a second security, the percentage of the total number of securities in issue represented by the issuer's short position from section 2b of the form.

mainDetails.part2bDerivativesobject

The number of derivatives held.

part2bDerivatives.longnumber

For a second security, the number of long derivatives held from section 2b of the form.

part2bDerivatives.longPercentagenumber

For a second security, the percentage of the total number of securities in issue represented by the issuer's long derivative position from section 2b of the form.

part2bDerivatives.shortnumber

For a second security, the number of short derivatives held from section 2b of the form.

part2bDerivatives.shortPercentagenumber

For a second security, the percentage of the total number of securities in issue represented by the issuer's short derivative position from section 2b of the form.

mainDetails.part2bOptionsAndAgreementsobject

The number of options and agreements held.

part2bOptionsAndAgreements.longnumber

For a second security, the number of long options held from section 2b of the form.

part2bOptionsAndAgreements.longPercentagenumber

For a second security, the percentage of the total number of securities in issue represented by the issuer's long options position from section 2b of the form.

part2bOptionsAndAgreements.shortnumber

For a second security, the number of short options held from section 2b of the form.

part2bOptionsAndAgreements.shortPercentagenumber

For a second security, the percentage of the total number of securities in issue represented by the issuer's short options position from section 2b of the form.

mainDetails.part2bTotalobject

The number of relevant securities, derivatives and options held.

part2bTotal.longnumber

For a second security, the aggregate of the issuer's long holdings of relevant securities, derivatives and options from section 2b of the form.

part2bTotal.longPercentagenumber

For a second security, the issuer's total long position as a percentage of securities in issue from section 2b of the form.

part2bTotal.shortnumber

For a second security, the aggregate of the issuer's short holdings of relevant securities, derivatives and options from section 2b of the form.

part2bTotal.shortPercentagenumber

For a second security, the issuer's total short position as a percentage of securities in issue from section 2b of the form.

mainDetails.part2cDetailsstring

Other /Rights to subscribe.

mainDetails.disclosureDatestring

Date of publication of 8.3 or amended 8.3.

mainDetails.contactNamestring

Issuer contact name.

mainDetails.phoneNumberstring

Contact telephone number for issuer.

mainDetails.totalAffectedstring

Indicates whether the total net holding of the issuer after the trade agrees with the expected total net holding based on previous position and trades reported.

mainDetails.notesstring

Any additional notes provided by issuer.

attributesobject

Contains RNS Number provided in filing and Notes added by M&A Monitor.

attributes.rnsNumberstring

RNS number as shown on original filing.

attributes.notesstring

Explanatory notes added by M&A Monitor.

otherobject

M&A Monitor database deal number (if any).

other.dealNostring

Deal number per the M&A Monitor database (if any).

openPositionsarray

List of openPosition objects.

productstring

Option type held as disclosed in Supplemental Form.

actionstring

Whether written or purchased, as disclosed in Supplemental Form.

longShortstring

Whether resulting position is long or short, as disclosed in Supplemental Form.

adrstring

Number of ADRs to which the option relates (if applicable), as disclosed in Supplemental Form.

numberOfSecuritiesnumber

Number of securities to which the option relates, as disclosed in Supplemental Form.

pricePerUnitnumber

Option price, as disclosed in Supplemental Form..

currencystring

Currency of option price, as disclosed in Supplemental Form.

typestring

Whether American or European, as disclosed in Supplemental Form.

expiryDatestring

Expiry date, as disclosed in Supplemental Form.

Endpoints

Trades

Provides details of trades in relevant securities, derivatives and options.

Parameters

idrequired

An integer identifier of the announcement. This is the id that is returned from the /search API end-point.

Returns

purchasesAndSalesarray

A list of purchasesAndSale objects purchases and sales disclosed in section 3a of the form.

actionstring

Describes the trade in the relevant security

adrstring

Provides the number of ADRs traded (if applicable)

numberOfSecuritiesnumber

Provides the number of relevant securities traded in a particular trade at a given price (or the security equivalent of the ADRs traded, if applicable)

pricePerUnitnumber

The price at which the trade was effected.

currencystring

The currency that the price is reported in.

derivativesarray

List of derivative objects.

productstring

Describes the derivative.

longShortstring

Indicates whether the trade was long or short.

adrstring

Provides the number of ADRs traded (if applicable)

numberOfSecuritiesnumber

Provides the number of derivatives traded in a particular trade at a given price (or the seccuirty equivalent of the ADRs traded, if applicable)

pricePerUnitnumber

The price at which the trade was effected.

currencystring

The currency that the price is reported in.

optionsTransactionsarray

List of optionsTransaction objects.

productstring

Describes option traded

actionstring

Describes nature of option trade

longShortstring

Denotes whether trade is long or short.

adrstring

Provides number of ADRs to which option trade relates.

numberOfSecuritiesnumber

Provides number of securities to which option trade relates.

pricePerUnitnumber

Provides price of option trade.

currencystring

Currency of option trade price.

typestring

Describes whether American or European opions traded.

expiryDatestring

Option expiry date.

moneyPaidReceivedstring

Option money paid, if applicable.

exercisingarray

List of exercisingItem objects.

productstring

Nature of option exercised

adrstring

Number of ADRs associated with exercised option (if applicable)

numberOfSecuritiesnumber

Number of securities associated with exercised option.

pricePerUnitnumber

Price of exercised option.

currencystring

Currency of exercised option.

otherDealingsarray

List of otherDealing objects.

natureOfTransactionstring

Nature of transaction

detailsstring

Details

pricePerUnitnumber

Price per unit

currencystring

Currency

Endpoints

Calculated

Provides details of calculations made by M&A Monitor (totals, vwaps etc) and other relevant figures not provided in the 8.3 filings.

Parameters

idrequired

An integer identifier of the announcement. This is the id that is returned from the /search API end-point.

Returns

purchasesAndSalesobject

Details of trades in relevant securities.

purchasesAndSales.totalPurchasesnumber

The total number of relevant securities purchased or transferred in.

purchasesAndSales.totalPurchasesExcludingTransfersnumber

The total number of relevant securities purchased, excluding transfers.

purchasesAndSales.totalSalesnumber

The total number of relevant securities sold or transferred out.

purchasesAndSales.totalSalesExcludingTransfersnumber

The total number of relevant securities sold, excluding transfers.

purchasesAndSales.totalNetnumber

The net of purchases and sales and transfers in/out of relevant securities.

purchasesAndSales.totalNetExcludingTransfersnumber

The net of purchases and sales of relevant securities, excluding transfers.

purchasesAndSales.totalNetExcludingTransfersOfTotalShareCapnumber

Net purchases and sales, excluding transfers, as a percentage of total number of relevant securities in issue.

derivativesobject

Details of trades in derivatives.

derivatives.totalLongnumber

Total increase in long derivatives (or reduction in short derivatives).

derivatives.totalLongExcludingTransfersnumber

Total increase in long derivatives (or reduction in short derivatives), excluding transfers.

derivatives.totalShortnumber

Total increase in short derivatives (or reduction in long derivatives).

derivatives.totalShortExcludingTransfersnumber

Total increase in short derivatives (or reduction in long derivatives), excluding transfers.

derivatives.totalNetnumber

The net of long and short derivative trades and transfers on a particular day.

derivatives.totalNetExcludingTransfersnumber

The net of long and short derivative trades on a particular day, excluding transfers.

derivatives.totalNetExcludingTransfersOfTotalShareCapnumber

Net derivative trades, excluding transfers, as a percentage of total number of relevant securities in issue.

derivatives.percentageOfLongDerivativesClassnumber

Long derivatives added and short derivatives sold as a percentage of long derivatives held prior to trade (NB a reducing short is treated as a long).

derivatives.percentageOfShortDerivativesClassnumber

Short derivatives added and long derivatives sold as a percentage of short derivatives held prior to trade (nb a reducing long is treated as a short).

derivatives.percentageOfLongTotalClassnumber

Long derivatives added and short derivatives sold as a percentage of total long position held prior to trade. (nb a reducing short is treated as a long).

derivatives.percentageOfShortTotalClassnumber

Short derivatives added and long derivatives sold as a percentage of total short position held prior to trade (nb a reducing long is treated as a short).

optionsTransactionsobject

Details of trades in options.

optionsTransactions.totalLongnumber

Total number of long options added (or short options sold).

optionsTransactions.totalLongExcludingTransfersnumber

Total number of long options added or short options sold, excluding transfers.

optionsTransactions.totalShortnumber

Total number of short options added (or long options sold).

optionsTransactions.totalShortExcludingTransfersnumber

Total number of short options added or long options sold, excluding transfers.

optionsTransactions.percentageOfLongOptionsClassnumber

Long options traded as a percentage of long options held prior to trade.

optionsTransactions.percentageOfShortOptionsClassnumber

Long options traded as a percentage of total long position held prior to trade.

optionsTransactions.percentageOfLongTotalClassnumber

Short options traded as a percentage of short options held prior to trade.

optionsTransactions.percentageOfShortTotalClassnumber

Short options traded as a percentage of total short position held prior to trade.

openPositionsobject

Totals of long and short options held.

openPositions.totalLongstring

Total number of long options held.

openPositions.totalShortstring

Total number of short options held.

relevantSecuritiesTransfersInnumber

The total number of relevant securities transferred in.

relevantSecuritiesTransfersOutnumber

The total number of relevant securities transferred out.

relevantSecuritiesNetTransfersnumber

The net of transfers in and out of relevant securities.

derivativesTransfersInnumber

The total number of derivatives transferred in.

derivativesTransfersOutnumber

The total number of derivatives transferred out.

derivativesNetTransfersnumber

The net of transfers in and out of derivatives.

assetsUnderManagementnumber

Provides an indication of the issuer's assets under management in billions of USD.

longShortMarketValueExcludeOptionsnumber

GBP Value of issuer's net position at closing share price on day of most recent trade NOT INCLUDING OPTIONS.

longShortMarketValuenumber

GBP Value of issuer's net position at closing share price on day of most recent trade.

currentLongShortMarketValueExcludeOptionsnumber

GBP Value of issuer's net position at latest target closing share price recorded by M&A Monitor NOT INCLUDING OPTIONS.

currentLongShortMarketValuenumber

GBP Value of issuer's net position at latest target closing share price recorded by M&A Monitor.

fundInCompanynumber

Percentage of issuer's assets under management represented by net position in target valued at current closing share price (not at closing price on day of most recent trade).

sharesAndDerivativesBoughtnumber

Total number of relevant securities purchased plus long derivatives added on the dealing date (excluding transfers).

sharesAndDerivativesSoldnumber

Total number of relevant securities sold plus short derivatives added on the dealing date (excluding transfers).

optionsNetnumber

Net of long and short options added.

netRelevantSecuritiesHeldnumber

Long relevant securities held minus short relevant securities held.

netDerivativesHeldnumber

Total long derivatives held minus total short derivatives held.

netOptionsHeldnumber

Total long options held minus total short options held.

netDailyTradingnumber

Net of the day's purchases, sales and long and short derivative trades, including transfers.

netDailyTradingExcludingTransfersnumber

Net of the day's purchases, sales and long and short derivative trades, excluding transfers.

netRelevantSecuritiesHeldOfTotalShareCapnumber

Net relevant securities held as a % of Total number of relevant securities in issue.

netDerivativesHeldOfTotalShareCapnumber

Net derivatives held as a % of Total number of relevant securities in issue.

netOptionsHeldOfTotalShareCapnumber

Net options held as a % of Total number of relevant securities in issue.

totalValueOfAllTradesnumber

Total Value in GBP of all trades in relevant securities and derivatives (aggregate, not the net of these so for example, £1 of sales + £1 of purchases = £2 of value).

totalValueOfPurchasesRelevantSecuritiesnumber

Value in GBP of a day's purchases of relevant securities based on data in section 3 of the form.

totalValueOfSalesRelevantSecuritiesnumber

Value in GBP of a day's sales of relevant securities based on data in section 3 of the form.

totalValueOfAllRelevantSecuritiesnumber

Total value in GBP of a day's trades in relevant securities based on data in section 3 (aggregate, not the net of these so for example, £1 of sales + £1 of purchases = £2 of value).

totalValueOfLongTradesInDerivativesnumber

Value in GBP of a day's long derivative trades based on data in section 3 of the form.

totalValueOfShortTradesInDerivativesnumber

Value in GBP of a day's short derivative trades based on data in section 3 of the form.

totalValueOfAllTradesInDerivativesnumber

Total value in GBP of a day's derivatives trades based on data in section 3 of the form (aggregate, not the net of these so for example, £1 of sales + £1 of purchases = £2 of value).

movementsInTradingCompanyobject

Long, short and net movements on a day as percentages of issuer's total holding the previous day.

movementsInTradingCompany.purchasedstring

Long movements for the day (purchases, transfers in, long derivative trades, transfers in of derivatives, and long options added) as a percentage of the previous day's holding total net holding.

movementsInTradingCompany.soldstring

Short movements for the day (sales, transfers out, short derivative trades, transfers out of derivatives, and short options added) as a percentage of the previous day's holding total net holding.

movementsInTradingCompany.netstring

Net movements for a day (sales, purchases, transfers in and out, short and long derivative trades, transfers in and out of derivatives, and long and short options added) as a percentage of the previous day's holding total net holding.

movementsInTargetCompanyobject

Movements as percentage of relevant securities in issue.

movementsInTargetCompany.longnumber

Long movements for the day (purchases, transfers in, long derivatives, transfers in of derivatives, and Long options) as a percentage of the total number of relevant securities in issue.

movementsInTargetCompany.shortnumber

Short movements for the day (sales, transfers out, short derivative trades, transfers out of derivatives, and short options added) as a percentage of the total number of relevant securities in issue.

vwapobject

VWAPs of purchases and sales of relevant securities, of derivative trades and of option trades.

vwap.purchasesAndSalesstring

List of vwapItem objects. Details of volume weighted average prices of purchases and sales.

namestring

Purchase or sell VWAP.

pricenumber

VWAP

vwap.derivativesstring

List of vwapItem objects. Details of volume weighted average prices of long and short derivatives.

namestring

Long or short VWAP.

pricenumber

VWAP

vwap.optionsTransactionsstring

List of vwapItem objects. Details of volume weighted average prices of options.

namestring

Long or short VWAP.

pricenumber

VWAP

vwap.combinedCurrencyPurchaseAndSalesstring

List of vwapItem objects. VWAP in GBP which provides an average prices of purchases and sales for a day's in all currencies

namestring

Purchases Combined Currency VWAP GBP.

pricenumber

A single VWAP in GBP which provides an average price for a day's purchases in all currencies.

namestring

Sales Combined Currency VWAP GBP.

pricenumber

A single VWAP in GBP which provides an average price for a day's sales in all currencies.

vwap.combinedCurrencyLongAndShortDerivativesstring

List of vwapItem objects. VWAP in GBP which provides an average of long and short derivatives prices for a day's in all currencies

namestring

Long Deriv Comb Currency VWAP GBP.

pricenumber

A single VWAP in GBP which provides an average price for a day's long derivative trades in all currencies.

namestring

Short Deriv Comb Currency VWAP GBP.

pricenumber

A single VWAP in GBP which provides an average price for a day's short derivative trades in all currencies.

Endpoints

Share register

Includes all fields associated with the M&A Monitor Share Register based on published 8.3 data.

Parameters

idrequired

An integer identifier of the announcement. This is the id that is returned from the /search API end-point.

dateoptional

A string date. This should usually be the dealing date that corresponds to the ID number entered.
Note: Unless this is entered in addition to an ID, the system will return just the very latest share register available for the company dealt in. The user should enter the date (dateOfDealing) as a parameter to return the Share Register from the time of the filing represented by the ID.

Returns

rnsIdstring

id

rnsDataIdOriginalstring

M&A Monitor page reference for unprocessed filing.

rnsDataIdProcessedstring

M&A Monitor page reference for processed filing.

currentRanknumber

Current position in M&A Monitor Share Register Table (based on net of long and short holdings disclosed in 8.3s).

investorstring

This is the name of the party issuing the 8.3.

lastProcessedAtdate

Date and time of last recorded 8.3 filing by this issuer

initialLongnumber

Total long from issuer's opening position (zero if no opening position available).

initialLongPercentagenumber

Total long percentage from issuer's opening position (zero if no opening position available).

initialShortnumber

Total short from issuer's opening position (zero if no opening position available).

initialShortPercentagenumber

Total short percentage from issuer's opening position (zero if no opening position available).

initialNetnumber

Total net position from issuer's opening position (zero if no opening position available).

initialNetPercentagenumber

Total net percentage from issuer's opening position (zero if no opening position available).

initialRanknumber

Initial position in M&A Monitor Share Register Table (based on net of long and short holdings disclosed in opening position (NUL if no opening position available).

initialNetRelevantSecuritiesHeldnumber

Net relevant securities held from opening position (zero if no opening position available).

initialNetDerivativesHeldnumber

Net derivative held from opening position (zero if no opening position available).

initialNetOptionsHeldnumber

Net options held from opening position (zero if no opening position available).

currentLongnumber

Latest total long position.

currentLongPercentagenumber

Latest total long position as percentage of relevant securities in issue.

currentShortnumber

Latest total short position.

currentShortPercentagenumber

Latest total short position as percentage of relevant securities in issue.

currentNetnumber

Net of latest long and short positions.

currentNetPercentagenumber

Net of latest long and short positions as percentage of relevant securities in issue.

changeFromInitialLongnumber

Latest long minus total long at the start of the offer period (position at the start of the offer period is assumed to have been zero if no opening position is available).

changeFromInitialLongPercentagenumber

Latest long percentage minus total long percentage at the start of the offer period (position at the start of the offer period is assumed to have been zero if no opening position is available).

changeFromInitialShortnumber

Latest short minus total short at the start of the offer period (position at the start of the offer period is assumed to have been zero if no opening position is available).

changeFromInitialShortPercentagenumber

Latest short percentage minus total short percentage at the start of the offer period (position at the start of the offer period is assumed to have been zero if no opening position is available).

changeFromInitialNetnumber

Latest net position minus net position at the start of the offer period (position at the start of the offer period is assumed to have been zero if no opening position is available).

changeFromInitialNetPercentagenumber

Latest net percentage minus total net percentage at the start of the offer period (position at the start of the offer period is assumed to have been zero if no opening position is available).

netPercentageChangeFromInitialHoldingnumber

The percentage by which the issuer's net position has changed since its opening position (ie change as a percentage of its opening position not as a percentage of securities in issue). Where no opening position is recorded, this field will be zero.

changeInNetRelevantSecuritiesInitialnumber

Current net relevant securities held minus net relevant securities held in the opening position (if no opening position is available this will be idential to current net relevant securities held).

changeInNetDerivativesInitialnumber

Current net derivatives held minus net derivatives held in the opening position (if no opening position is available this will be idential to current net derivatives held).

changeInNetOptionsInitialnumber

Current net options held minus net options held in the opening position (if no opening position is available this will be idential to current net options held).

changeInNetRelevantSecuritiesInitialTotalShareCapnumber

Current net relevant securities held expressed as a percentage of current total relevant securities in issue minus net relevant securities held in the opening position expressed as a percentage of initial total relevant securities in issue (if no opening position is available this will be idential to current net relevant securities held expressed as a percentage of current total relevant securities in issue).

changeInNetDerivativesInitialTotalShareCapnumber

Current net derivative position expressed as a percentage of current total relevant securities in issue minus net derivative held in the opening position expressed as a percentage of initial total relevant securities in issue (if no opening position is available this will be idential to current net derivatives held expressed as a percentage of current total relevant securities in issue).

changeInNetOptionsInitialTotalShareCapnumber

Current net options position expressed as a percentage of current total relevant securities in issue minus net options held in the opening position expressed as a percentage of initial total relevant securities in issue (if no opening position is available this will be idential to current net options held expressed as a percentage of current total relevant securities in issue).

totalLongFromPreviousnumber

Total long position from previous filing.

totalLongPercentageFromPreviousnumber

Total long position from previous filing in percentage terms.

totalShortFromPreviousnumber

Total short position from previous filing.

totalShortPercentageFromPreviousnumber

Total short position from previous filing in percentage terms.

previousFilingNetnumber

Net of total long and total short positions reported in previous filing.

previousFilingNetPercentagenumber

Net of total long and total short positions reported in previous filing in percentage terms.

netChangeFromPreviousnumber

Change in net position since previous filing.

netChangePercentageFromPreviousnumber

Change in net percentage holding since previous filing.

shortChangeFromPreviousnumber

Change in short position since previous filing.

shortChangePercentageFromPreviousnumber

Change in short percentage holding since previous filing.

longChangeFromPreviousnumber

Change in long position since previous filing.

longChangePercentageFromPreviousnumber

Change in long percentage holding since previous filing.

firstKnownPositionLongnumber

This is the first known long position for an issuer in an offer period. It may differ from the "Initial long", which is assumed to be NIL when there is no known figure for the start of the offer period.

firstKnownPositionLongPercentagenumber

This is the first known long position for an issuer in an offer period expressed as a percentage of the target's securities in issue. It may differ from the "Initial long percentage", which is assumed to be NIL when there is no known figure for the start of the offer period.

firstKnownPositionShortnumber

This is the first known short position for an issuer in an offer period. It may differ from the "Initial short", which is assumed to be NIL when there is no known figure for the start of the offer period.

firstKnownPositionShortPercentagenumber

This is the first known short position for an issuer in an offer period expressed as a percentage of the target's securities in issue. It may differ from the "Initial short percentage", which is assumed to be NIL when there is no known figure for the start of the offer period.

firstKnownPositionNetnumber

This is the first known net position for an issuer in an offer period. It may differ from the "Initial net", which is assumed to be NIL when there is no known figure for the start of the offer period.

firstKnownPositionNetPercentagenumber

This is the first known net position for an issuer in an offer period expressed as a percentage of the target's securities in issue. It may differ from the "Initial net percentage", which is assumed to be NIL when there is no known figure for the start of the offer period.

changeFromFirstKnownPositionLongnumber

Latest long position minus First known long position for an issuer in an offer period.

changeFromFirstKnownPositionLongPercentagenumber

Latest long percentage minus First known long percentage for an issuer in an offer period.

changeFromFirstKnownPositionShortnumber

Latest short position minus First known short position for an issuer in an offer period.

changeFromFirstKnownPositionShortPercentagenumber

Latest short percentage minus First known short percentage for an issuer in an offer period.

changeFromFirstKnownPositionNetnumber

Latest net position minus First known net position for an issuer in an offer period.

changeFromFirstKnownPositionNetPercentagenumber

Latest net percentage minus First known net percentage for an issuer in an offer period.

Endpoints

M&A Deal Report Endpoint

Includes M&A Deal Report.

Parameters

idrequired

A deal number assigned to an M&A Database deal report. This is an integer companyDeals that is returned from the /search API end-point. It is an essential parameter to be used to return a response from the M&A Deal Report Endpoint

Returns

tunamestring

The name of the "Target" company in the M&A deal report associated with the dealNo used in the Request/GET.

targetISINstring

The International Securities Identification Number associated with a Target's shares (if any).

tuctrystring

The country of the "Target" company.

ftsiestring

The Stock Exchange index the "Target" company was included in at the time of the deal (if any).

tusic1string

Suggested SIC code (first) associated with the activities of the Target company.

tusic2string

Suggested SIC code (second) associated with the activities of the Target company.

tusic3string

Suggested SIC code (third) associated with the activities of the Target company.

tusic4string

Suggested SIC code (fourth) associated with the activities of the Target company.

tusic5string

Suggested SIC code (fifth) associated with the activities of the Target company.

bnamestring

The name of the company bidding for the "Target" company.

bctrystring

The country of the Bidder.

bidderISINstring

The International Securities Identification Number associated with a Bidder's (offeror's) shares (if any).

bsic1string

Suggested SIC code (first) associated with the activities of the Bidder company.

bsic2string

Suggested SIC code (second) associated with the activities of the Bidder company.

bsic3string

Suggested SIC code (third) associated with the activities of the Bidder company.

bsic4string

Suggested SIC code (fourth) associated with the activities of the Bidder company.

bsic5string

Suggested SIC code (fifth) associated with the activities of the Bidder company.

dateanndate

The date that the deal was formally announced. For UK Public Takeovers, this is the date of the 2.7 Announcement.

Endpoints

Search announcements - v2

Returns a list of all Rule 8.3 announcements that match your search criteria in pagination. The results are returned in descending order of rnsDataId. Results are paged using the page filter parameter.

You may get less than 10 records in page when you are using companyType, targetISIN, and bidderISIN filters as in new implementation we are filtering records on memory level not on database level.

There are various filters that can be optionally passed to the end-point to get a list of announcements you are interested in. The filters need to be Posted to the end-point.

Parameters

companyDealtInCommonNameoptional

A filter based on the company being traded in. The name entered is checked against the Common Name of the company whose securities are the subject of the 8.3, as used by M&A Monitor to connect filings that contain slight variants of that company's name in Box 1c. The value should be a string and the results are returned where the string appears anywhere in the Common Name of the company. Note: requests with this filter present take longer to execute due to the searching requirement.

dealingCompanyCommonNameoptional

A filter based on the company initiating the trade. The name entered is checked against the Common Name of the party issuing the 8.3, as used by M&A Monitor to connect filings that contain slight variants of that company's name in Box 1a. The value should be a string and the results are returned where the string appears anywhere in the Common Name of the company. Note: requests with this filter present take longer to execute due to the searching requirement.

companyDealtInoptional

An alternative, more restricted filter based on the company being traded in. The value should be a string and the results are returned where the string appears anywhere in the name of the company as recorded in Box 1c of the filing. Note: requests with this filter present take longer to execute due to the searching requirement.

tradingCompanyoptional

An alternative, more restricted filter based on the company initiating the trade. The value should be a string and the results are returned where the string appears anywhere in the name of the company as recorded in Box 1a of the filing. Note: requests with this filter present take longer to execute due to the searching requirement.

classoptional

A filter based on the class of relevant security. The value should be one of the following options: ALL, ORDINARIES, OTHER. If this field is omitted, then results for ALL classes will be returned.

dealingDateFromoptional

A filter based on the date the trade was executed. If present, only filings for trades executed on or after this date will be returned. The value should be a date in the ISO 8601 format (YYYY-MM-DD), e.g. 2020-01-02 to specify 2nd January 2020.

dealingDateTooptional

A filter based on the date the trade was executed. If present, only filings for trades executed on or before this date will be returned. The value should be a date in the ISO 8601 format (YYYY-MM-DD), e.g. 2020-01-02 to specify 2nd January 2020.

announcementDateFromoptional

A filter based on the date the trade was announced If present, only filings for trades announced on or after this date will be returned. The value should be a date in the ISO 8601 format (YYYY-MM-DD), e.g. 2020-01-02 to specify 2nd January 2020.

announcementDateTooptional

A filter based on the date the trade was announced If present, only filings for trades announced on or before this date will be returned. The value should be a date in the ISO 8601 format (YYYY-MM-DD), e.g. 2020-01-02 to specify 2nd January 2020.

targetISINoptional

A filter based on The International Securities Identification Number associated with a Target's shares (if any). e.g. "USXXXXXXXXXX"

bidderISINoptional

A filter based on the International Securities Identification Number associated with a Bidder's (offeror's) shares (if any). e.g. "USXXXXXXXXXX"

companyTypeoptional

A filter based on an investor (Trading Company) classification assigned by M&A Monitor from the list: Bank/Stockbroker, Corporate, Family Office, Hedge Fund, Institutional Investor, Pension Fund/Nominees, Private Equity Investor, Private Investor, Sovereign Wealth Fund.

pageoptional

The API endpoint response is paginated. page can be a valid integer value and the default is 1. You need to loop through pages until the associative array data in reponse is empty

Returns

An associative array with a data property that contains an array of up to 10 announcements.

idnumber

The unique identifier of the announcement.

companyDealtInCommonNamestring

This is the Common Name of the company whose securities are the subject of the 8.3, as used by M&A Monitor to connect filings that contain slight variants of that company's name in Box 1c

dealingCompanyCommonNamestring

This is the Common Name of the party issuing the 8.3, as used by M&A Monitor to connect filings that contain slight variants of that company's name in Box 1a

companyDealtInstring

The name of the company/stock being traded in within the announcement.

tradingCompanystring

The name of the company performing the trade

dateOfDealingstring

The date that the trade occurred in YYYY-MM-DD format. Note that this is not necessarily the date the announcement was filed.

rnsDataIdnumber

The ID of the announcement as assigned by the RNS. Note that M&A Monitor's id property should be used within all API calls.

announcementDatestring

The date that the trade was announced in a filing. The date is in a YYYY-MM-DD format.

companyDealsstring

Deal numbers assigned to M&A Database deal reports in which the company identified by the companyDealtInCommonName is recorded as a Target or Bidder at the time of the dateOfDealing. These identifiers can be subsequently passed to the/deal-details API to GET more details of the deal.

targetISINstring

The International Securities Identification Number associated with a Target's shares (if any).

bidderISINstring

The International Securities Identification Number associated with a Bidder's (offeror's) shares (if any).

companyTypestring

An investor (Trading Company) classification assigned by M&A Monitor from the list: Bank/Stockbroker, Corporate, Family Office, Hedge Fund, Institutional Investor, Pension Fund/Nominees, Private Equity Investor, Private Investor, Sovereign Wealth Fund