Equities

Company Profile

GET/v2/equities/profile

Returns company identity, classification, and market data.

This endpoint is equity-specific. For ETF or fund profiles, use the ETF or Fund domain.

Included in: Startup, Pro, Growth.

Authentication

Send your API key in the x-api-key header on every request to https://api.bavest.co. The samples read it from the BAVEST_API_KEY environment variable. Get an API key · Authentication guide

Parameters

Required: one of symbol, isin, for example symbol=AAPL.

Name	In	Type	Required	Description
symbol	query	string	one of symbol, isin	Stock ticker symbol (e.g., `AAPL`, `MSFT`, `GOOGL`). Provide exactly one of symbol or isin. Example `AAPL`
isin	query	string	one of symbol, isin	ISIN code (e.g., `US0378331005`). Provide exactly one of symbol or isin. Clear the symbol example before using an ISIN.

Try it

symbol query

Stock ticker symbol (e.g., `AAPL`, `MSFT`, `GOOGL`). Provide exactly one of symbol or isin.

isin query

ISIN code (e.g., `US0378331005`). Provide exactly one of symbol or isin. Clear the symbol example before using an ISIN.

GET /v2/equities/profile?symbol=AAPL

API key

Sent only to api.bavest.co for this request; not stored.

Sign in to send Get an API keySends with the key above, or sign in to use your account's key. Each request counts as one API call.

curl 'https://api.bavest.co/v2/equities/profile?symbol=AAPL' \
  -H "x-api-key: $BAVEST_API_KEY"

Samples read your key from BAVEST_API_KEY and follow the form.

Example response 200

{
  "data": {
    "symbol": "AAPL",
    "companyName": "Apple Inc.",
    "description": "Apple Inc. is a global technology corporation that specializes in the conceptualization, production, and sale of a diverse suite of electronic devices. Its comprehensive hardware lineup features the well-known iPhone smartphones, Mac personal computers, and versatile iPad tablets. The company also supplies a range of wearables, smart home products, and accessories, including AirPods, Apple TV, Apple Watch, items from the Beats brand, and HomePod speakers. Beyond its device offerings, Apple delivers essential support services like AppleCare and robust cloud solutions. It oversees key digital platforms, prominently the App Store, which acts as a central hub for customers to discover and download countless applications and digital content, from e-books and music to videos, games, and podcasts. The company also generates revenue via advertising, leveraging both its proprietary ad platforms and third-party licensing deals. Apple's ecosystem is further bolstered by a wide array of subscription-based services: Apple Arcade for gaming, Apple Fitness+ for personalized wellness, Apple Music for curated audio experiences and on-demand radio, Apple News+ for access to news and magazines, and Apple TV+ for exclusive original video programming. Its financial services portfolio includes the co-branded Apple Card and the mobile payment system, Apple Pay. Additionally, Apple strategically licenses its intellectual property. The company serves a broad clientele that spans individual consumers, small and medium-sized enterprises, as well as institutional clients in the education, corporate, and governmental sectors. Products are distributed through a multi-channel strategy, utilizing Apple's own physical retail locations and online storefronts, a dedicated direct sales team, and collaborations with external partners such as mobile network providers, wholesalers, general retailers, and authorized resellers. The App Store additionally functions as the primary conduit for third-party applications designed for its devices. Founded in 1976, Apple Inc. is headquartered in Cupertino, California.",
    "ceo": "John Ternus",
    "sector": "Technology",
    "industry": "Consumer Electronics",
    "country": "US",
    "state": "CA",
    "city": "Cupertino",
    "address": "One Apple Park Way",
    "zip": "95014",
    "phone": "(408) 996-1010",
    "website": "https://www.apple.com",
    "exchange": "NASDAQ Global Select",
    "exchangeShortName": "NASDAQ",
    "isin": "US0378331005",
    "cik": 320193,
    "ipo": "1980-12-12",
    "currency": "USD",
    "employeeTotal": 166000,
    "isActivelyTrading": true,
    "isAdr": false
  },
  "meta": {
    "parameters": {
      "symbol": "AAPL"
    },
    "time": 13
  }
}

From the docs, not your data. Long lists are cut to 3 items.

Response 200

Successful response · application/json

dataCompanyProfile
Company identity and classification. Equity-specific — no ETF/fund flags.
- symbolstringrequired
  Ticker symbol
  Example AAPL
- companyNamestringrequired
  Legal company name
  Example Apple Inc.
- descriptionstring
  Business summary of the company
- ceostring
  Chief Executive Officer name
  Example Timothy D. Cook
- sectorstring
  GICS sector
  Example Technology
- industrystring
  GICS industry
  Example Consumer Electronics
- countrystring
  ISO 3166-1 alpha-2
  Example US
- statestring
  State or province of headquarters
  Example CA
- citystring
  City of headquarters
  Example Cupertino
- addressstring
  Street address of headquarters
  Example One Apple Park Way
- zipstring
  Postal or ZIP code
  Example 95014
- phonestring
  Primary contact phone number
  Example (408) 996-1010
- websitestring (uri)
  Company website URL
  Example https://www.apple.com
- exchangestring
  Full name of the listing exchange
  Example NASDAQ Global Select
- exchangeShortNamestring
  Abbreviated exchange name
  Example NASDAQ
- isinstring
  International Securities Identification Number
  Example US0378331005
- cikstring | null
  SEC Central Index Key
  Example 320193
- ipostring (date) | null
  Initial public offering date
  Example 1980-12-12
- currencystring
  Primary trading currency (ISO 4217)
  Example USD
- employeeTotalinteger | null
  Total number of employees
  Example 164000
- isActivelyTradingboolean
  Whether the security is currently actively traded
  Example true
- isAdrboolean
  Whether the security is an American Depositary Receipt
  Example false
- isReitboolean | null
  Whether the company is a REIT (real estate investment trust): its industry starts with "REIT", e.g. Realty Income "REIT - Retail". Never true for ETFs or funds. null when no industry is known.
  Example true
metaResponseMeta
Response envelope metadata. Always present on a 200: time is set by core/response.py on every successful response. Errors carry the same block, built by the same code, so a client parses one meta shape whether the call succeeded or failed.
- timeinteger
  Server-side processing time in milliseconds
  Example 17
- parametersobject
  Echo of the request parameters the endpoint resolved

Errors

400Invalid request parameters. Returned when required query parameters are missing, have invalid types, or violate constraints (e.g., providing both symbol and isin when they are mutually exclusive).
401Missing or invalid API key.
404Resource not found.
429Rate limit exceeded. Retry after the `Retry-After` header interval.
500An unexpected error occurred on the server. If the issue persists, contact support with the X-Request-Id header value.
502Upstream data provider returned an error or is temporarily unavailable. Retry after a short delay.
504The request timed out waiting for a response from the upstream data provider. This may occur for complex queries or during peak load.
defaultAn unexpected error occurred on the server. If the issue persists, contact support with the X-Request-Id header value.