Skip to main content
GET
Companies List

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

ticker
string

Comma-separated ticker values. Plain tickers (e.g. AAPL) match the primary stock ticker. Exchange-prefixed values such as NASDAQ:AAPL are accepted and match by ticker symbol.

cik
string

Comma-separated CIK values to filter by. CIKs should include leading zeros when applicable, e.g. 0000320193.

sector
string

Comma-separated sectors to filter by, based on US industry classification.

industry
string

Comma-separated industries to filter by, based on US industry classification.

company_id
string

Comma-separated internal company IDs to filter by. For US companies, this is the full CIK.

marketcap_category
string

Comma-separated lowercase market-cap category keys. Client-supported inputs are mega, large, mid, small, micro, and nano.

Pattern: ^(mega|large|mid|small|micro|nano)(,(mega|large|mid|small|micro|nano))*$
sort
string

Sort specification as key:order pairs, comma-separated. Supported keys: company_name, marketcap_category. Supported orders: asc, desc. Example: company_name:asc or marketcap_category:desc,company_name:asc.

Pattern: ^((company_name|marketcap_category):(asc|desc))(,((company_name|marketcap_category):(asc|desc)))*$
page
integer

Page number for pagination. Defaults to 1.

Required range: x >= 1
limit
integer

Number of results per page. Defaults to 10000 (returns all companies).

Required range: x >= 1

Response

Successful response

status
enum<string>
Available options:
success
data
object[]
meta
object