Companies

What are companies?

Companies are a step above brands in the BAV hierarchy. Companies are the legal entities that own brands. These companies can be privately or publicly owned.

List all companies

To list all of the companies and browse them via the API, use the list endpoint:

GET /api/v2/companies

Get a company

You may also directly retrieve a company's details if you already have its system ID.

GET /api/v2/companies/123

Where 123 is the system ID of the company.

Schema

Full response schema

Key	Type	Filterable	Sortable	Configurable	Description
id	integer	✅ (exact)	✅	✅	The system ID.
name	string	✅	✅	✅	The primary name of the company.
description	string	✅	❌	✅	A description of what the company does.
currency	string	✅	✅	✅	The primary reporting currency for the company.
isin	string	✅	✅	✅	The company's ISIN number (if public).
ipo_date	string	✅	✅	✅	When the company first had its initial public offering.
fiscal_year_end	string	✅	✅	✅	The month when the company's fiscal year ends.
street_address	string	✅	✅	✅	The street address for the company's listed HQ.
state	string	✅	✅	✅	The state/region for the company's listed HQ.
postal_code	string	✅	✅	✅	The zip/postal code for the company's listed HQ.
city	string	✅	✅	✅	The city for the company's listed HQ.
website_url	string	✅	✅	✅	The company's primary website URL.
officers	array	✅	❌	✅	An array of names and roles of the registered company officers.
created_at	string	❌	✅	✅	A datetime string when this company was first created.
updated_at	string	(updated since)	✅	✅	A datetime string when this company was last updated.

Relationship Response Schema

The slim relationship schema is used when the company is used as part of an include in another resource.

Key	Type	Description
id	integer	The system ID for the company.
name	string	The primary name of the company.

Additional Filters

For convenience, we have a set of additional filters that are not available in the default filters or are part of the columns. These are:

• public - Set to 1 to only return public (listed) companies.
• private - Set to 1 to only return private (unlisted) companies.
• brands - Set to a comma-separated list of brand IDs to only return companies that own those brands.

Relationships & includes

By default, relationships apart from the sector are not included. See the includes section for more information on how this works. The following relationships are available:

• brand - The brand relation if the company name is also a tracked brand name.
• brands - The brands that belong to the company.
• gics_sector - The GICS Sector that categorizes the company.
• stock_exchanges - The stock exchanges that the company is listed on.
• country - The country that the company is headquartered in.
• latest_financials - The latest financials for the company (available for public companies).