Corporate activity coverage

Fetch corporate activity coverage information (companies and equities)

GET /corporate-activity/coverage

Parameter	Type	DataType	Description
bloomberg_ticker	query	string	Filter events to 1+ bloomberg tickers (comma-separated)
isin	query	string	Filter events to 1+ ISINs (comma-separated)
cusip	query	string	Filter events to 1+ CUSIPs (comma-separated)
ric	query	string	Filter events to 1+ Reuters/Refinitiv RICs (comma-separated)
permid	query	string	Filter to one or more PermID identifiers (comma-separated)
watchlist_id	query	integer	Filter to one or more watchlist IDs (comma-separated)

NOTE

If an identifier is not supplied (bloomberg_ticker, isin, cusip, ric, or ticker) then only count information will be returned

Response

{
    "counts": {
		"mapped": {
			"companies": 8041,
			"equities": 8651,
			"gics_sectors": {
				"Healthcare": 1436, ...
			},
			"gics_subsectors": {
				"Biotechnology": 637, ...
			},
			"countries": {
				"US": 4815, ...
			},"regions": {
                "Americas": 5377, ...
            },
            "subregions": {
                "North America": 5210, ...
            }
		},
		"unmapped": {
			"listed": 2506,
			"delisted": 4645
		}
	},
    "results": {
        "mapped": [
            {
                "company_id": 1,
                "name": "Amazon",
                "country": "US",
                "region": "Americas",
                "subregion": "North America",
                "equities": [
                    {
                        "equity_id": 1,
                        "bloomberg_ticker": "AMZN:US",
                        "local_ticker": "AMZN",
                        "ric": "AMZN.OQ",
                        "isin": "US0231351067",
                        "cusip": "023135106",
                        "permid": "4295905494",
                        "mic": "XNAS",
                        "gics_sector": "Consumer Discretionary",
                        "gics_subsector": "Internet & Direct Marketing Retail"
                    }
                ]
            },
            {
                "company_id": 378,
                "name": "Baidu",
                "country": "CN",
                "region": "Asia",
                "subregion": "Eastern Asia",
                "equities": [
                    {
                        "equity_id": 13,
                        "bloomberg_ticker": "BIDU:US",
                        "local_ticker": "BIDU",
                        "ric": "BIDU.OQ",
                        "isin": "US0567521085",
                        "cusip": "056752108",
                        "permid": "4295864818",
                        "mic": "XNAS",
                        "gics_sector": "Communication Services",
                        "gics_subsector": "Interactive Media & Services"
                    },
                    {
                        "equity_id": 21886,
                        "bloomberg_ticker": "9888:HK",
                        "local_ticker": "9888",
                        "ric": "9888.HK",
                        "isin": "KYG070341048",
                        "cusip": "056752108",
                        "permid": "4295864818",
                        "mic": "XHKG",
                        "gics_sector": "Communication Services",
                        "gics_subsector": "Interactive Media & Services"
                    }
                ]
            }, ...
        ],
        "unmapped": [
            {
                "name": "AAC Holdings Inc",
                "cusip": "000307108",
                "local_ticker": "AACH",
                "delisted": false
            },
            {
                "name": "ADC",
                "cusip": "000886309",
                "local_ticker": "ADCT1",
                "delisted": false
            }, ..
        ]
    }
]

Code Samples

Bash

curl --request GET \
  --url 'https://premium.aiera.com/api/corporate-activity/coverage' \
  --header 'X-API-Key: xxx'

Python

import requests
requests.request("GET", "https://premium.aiera.com/api/corporate-activity/coverage", headers={"X-API-Key": "xxx"})