Find companies

Fetch companies matching filter criteria

GET /companies-v1

Parameter	Type	DataType	Description
bloomberg_ticker	query	string	Filter to one or more Bloomberg tickers (comma-separated)
isin	query	string	Filter to one or more ISINs (comma-separated)
permid	query	string	Filter to one or more PermIDs (comma-separated)
ric	query	string	Filter to one or more Reuters/Refinitiv RICs (comma-separated)
cusip	query	string	Filter to one or more CUSIPs (comma-separated)
company_type	query	string	Filter by company type
ownership	query	string	Filter by ownership type
incorporated_country_code	query	string	Filter by incorporated country code
domiciled_country_code	query	string	Filter by domiciled country code
page	query	integer	The page of results to return
page_size	query	integer	The size of pages to return (default: 100, min: 10, max: 2500)

NOTE

Only one of the equity identifiers (bloomberg_ticker, isin, permid, ric, or cusip) should be used per request. Using multiple equity identifier query parameters will end up resolving only one of them.

Request

https://premium.aiera.com/api/companies-v1?bloomberg_ticker=AMZN:US

Response

{
  "params": {
    "bloomberg_ticker": "AMZN:US",
    "page_size": 100
  },
  "pagination": {
    "total_count": 1,
    "current_page": 1,
    "total_pages": 1,
    "page_size": 1
  },
  "data": [
    {
      "company_id": 1,
      "common_name": "Amazon",
      "legal_name": "Amazon.com Inc",
      "company_type": "corporation",
      "ownership": "public",
      "incorporated_country_code": "US",
      "domiciled_country_code": "US",
      "created": "2017-06-01T00:00:00",
      "modified": "2024-11-11T14:02:12",
      "equities": [
        {
          "equity_id": 1,
          "name": "AMAZON COM INC",
          "common_name": "AMAZON COM INC",
          "local_ticker": "AMZN",
          "mic": "XNAS",
          "bloomberg_ticker": "AMZN:US",
          "isin": "US0231351067",
          "permid": "4295905494",
          "sector_id": 1,
          "gics_sector": "Consumer Discretionary",
          "subsector_id": 259,
          "gics_sub_sector": "Broadline Retail",
          "primary_equity": true,
          "created": "2017-06-01T00:00:00",
          "modified": "2024-11-11T14:02:12",
          "status": "active"
        }
      ]
    }
  ]
}

Code Samples

Bash

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

Python

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