Skip to main content

​
Overview

Companies are the top-level entity in the Quartr data model. Every event, document, audio recording, and transcript traces back to a company through its companyId. The companies endpoint gives you access to company metadata and identifiers, and serves as the reference point for mapping between different identifier systems.

​
Company data

Each company record includes the following fields:
FieldDescription
idQuartr’s internal company identifier. Present in all API responses and used across all endpoints.
nameFull company name (e.g. “Apple Inc.”).
displayNameShortened display name (e.g. “Apple”).
countryISO 3166-1 alpha-2 country code (e.g. “US”, “SE”, “GB”).
tickersArray of exchange-ticker pairs. A company can have multiple listings across different exchanges.
isinsArray of ISIN codes. Globally unique and widely used in financial systems for cross-system matching.
cikSEC Central Index Key, available for US-listed companies. A 10-digit zero-padded string (e.g. "0000320193").
createdAtWhen the company record was first created in our system.
updatedAtWhen the company or any of its identifiers was last modified.

​
Identifiers

Matching companies across systems is a common challenge. The API supports four ways to identify a company: companyId, ticker, isin, and cik. You can query any endpoint using any of these. All endpoints except the companies endpoint only return companyId in their responses. If you need to map IDs back to tickers, ISINs, or CIKs, query the /companies endpoint with the ids parameter.
Company name search is not supported. Company names are ambiguous. “Delta” alone could refer to Delta Air Lines, Delta Electronics, or Delta Lithium. Use isin, ticker, cik, or companyId for reliable identification.

​
Tickers

A single company can be listed on multiple exchanges. The tickers array contains objects with a ticker symbol and an exchange identifier for each listing. For example, Apple has listings on both NasdaqGS and BASE. 
{
  "tickers": [
    { "ticker": "AAPL", "exchange": "NasdaqGS" },
    { "ticker": "AAPL", "exchange": "BASE" }
  ]
}

​
ISINs

ISINs (International Securities Identification Numbers) are globally unique 12-character identifiers. A company can have multiple ISINs if it has multiple securities issued.

​
CIKs

CIKs (Central Index Keys) are 10-digit identifiers assigned by the SEC to companies that file with them. CIK values are automatically zero-padded to 10 digits, so both 320193 and 0000320193 will match the same company.
CIK coverage is limited to companies that file with the SEC, which primarily includes US-listed companies.

​
Querying companies

The companies endpoint supports several filters that can be combined to build precise queries.

​
By identifier

The most direct way to retrieve companies. Use these when you already know which companies you need.
ParameterDescriptionMax items
idsComma-separated Quartr company IDs500
tickersComma-separated ticker symbols (e.g. “AAPL,AMZN”)100
isinsComma-separated ISIN codes100
ciksComma-separated SEC Central Index Keys (e.g. “0000320193,0001018724”)100
When filtering by ticker, all companies matching that symbol are returned regardless of exchange. To narrow results to a specific listing, combine the tickers and exchanges parameters.

​
By geography and exchange

Filter companies by where they are domiciled or listed.
ParameterDescriptionMax items
countriesComma-separated ISO 3166-1 alpha-2 country codes (e.g. “US,SE”)100
exchangesComma-separated exchange symbols (e.g. “NasdaqGS,NYSE”)100
These same company filters are available on all list endpoints across the API. See fetching data for details.

​
How to access this data

REST API

Query companies by ticker, ISIN, country, exchange, and more.

Webhooks

Subscribe to webhooks for real-time updates.

Snowflake

Query the companies view directly using SQL.