> ## Documentation Index
> Fetch the complete documentation index at: https://quartr.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Companies

> Company metadata, identifiers, and filtering

## 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:

| Field           | Description                                                                                                                                                  |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **id**          | Quartr's internal company identifier. Present in all API responses and used across all endpoints.                                                            |
| **name**        | Full company name (e.g. "Apple Inc.").                                                                                                                       |
| **displayName** | Shortened display name (e.g. "Apple").                                                                                                                       |
| **country**     | ISO 3166-1 alpha-2 country code (e.g. "US", "SE", "GB").                                                                                                     |
| **tickers**     | Array of exchange-ticker pairs. A company can have multiple listings across different exchanges.                                                             |
| **isins**       | Array of ISIN codes. Globally unique and widely used in financial systems for cross-system matching.                                                         |
| **cik**         | SEC Central Index Key, available for US-listed companies. A 10-digit zero-padded string (e.g. `"0000320193"`).                                               |
| **openfigi**    | Array of OpenFIGI share-class identifiers (global share-class level, e.g. `"BBG001S5N8V8"`). Useful for cross-mapping to Bloomberg's open identifier scheme. |
| **createdAt**   | When the company record was first created in our system.                                                                                                     |
| **updatedAt**   | When the company or any of its identifiers was last modified.                                                                                                |

## Identifiers

Matching companies across systems is a common challenge. The API supports five ways to identify a company: `companyId`, `ticker`, `isin`, `cik`, and `openfigi`. 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, CIKs, or OpenFIGI codes, query the `/companies` endpoint with the `ids` parameter.

<Note>
  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.
</Note>

### 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`.

```json theme={null}
{
  "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.

<Note>
  CIK coverage is limited to companies that file with the SEC, which primarily includes US-listed companies.
</Note>

## 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.

| Parameter     | Description                                                             | Max items |
| ------------- | ----------------------------------------------------------------------- | --------- |
| **ids**       | Comma-separated Quartr company IDs                                      | 500       |
| **tickers**   | Comma-separated ticker symbols (e.g. "AAPL,AMZN")                       | 100       |
| **isins**     | Comma-separated ISIN codes                                              | 100       |
| **ciks**      | Comma-separated SEC Central Index Keys (e.g. "0000320193,0001018724")   | 100       |
| **openfigis** | Comma-separated OpenFIGI codes (figi, compositeFigi, or shareClassFigi) | 100       |

<Note>
  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.
</Note>

### By geography and exchange

Filter companies by where they are domiciled or listed.

| Parameter     | Description                                                     | Max items |
| ------------- | --------------------------------------------------------------- | --------- |
| **countries** | Comma-separated ISO 3166-1 alpha-2 country codes (e.g. "US,SE") | 100       |
| **exchanges** | Comma-separated exchange symbols (e.g. "NasdaqGS,NYSE")         | 100       |

<Info>
  These same company filters are available on all list endpoints across the API. See [fetching data](/rest-api/fetching-data#company-filters) for details.
</Info>

## How to access this data

<CardGroup cols={3}>
  <Card title="REST API" icon="code" href="/api-reference/companies">
    Query companies by ticker, ISIN, country, exchange, and more.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/webhooks/getting-started">
    Subscribe to webhooks for real-time updates.
  </Card>

  <Card title="Snowflake" icon="snowflake" href="/snowflake/getting-started">
    Query the companies view directly using SQL.
  </Card>
</CardGroup>