# Company Profile

> Returns company identity, classification, and market data.

`GET https://api.bavest.co/v2/equities/profile`

Group: Equities. Route id: `v2_equities_profile`. Included in: Startup, Pro, Growth.

## Description

Returns company identity, classification, and market data.

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

## Authentication

Send your API key in the `x-api-key` header on every request. No key yet? Sign up at https://dashboard.bavest.co/sign-up (free trial). The examples read the key from the `BAVEST_API_KEY` environment variable.

## Parameters

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

Required: one of `symbol`, `isin`.

## Response

200 Successful response (`application/json`).

| Field | Type | Always present | Description |
|---|---|---|---|
| `data` | CompanyProfile | no | Company identity and classification. Equity-specific — no ETF/fund flags. |
| `data.symbol` | string | yes | Ticker symbol. Example: `AAPL`. |
| `data.companyName` | string | yes | Legal company name. Example: `Apple Inc.`. |
| `data.description` | string | no | Business summary of the company. |
| `data.ceo` | string | no | Chief Executive Officer name. Example: `Timothy D. Cook`. |
| `data.sector` | string | no | GICS sector. Example: `Technology`. |
| `data.industry` | string | no | GICS industry. Example: `Consumer Electronics`. |
| `data.country` | string | no | ISO 3166-1 alpha-2. Example: `US`. |
| `data.state` | string | no | State or province of headquarters. Example: `CA`. |
| `data.city` | string | no | City of headquarters. Example: `Cupertino`. |
| `data.address` | string | no | Street address of headquarters. Example: `One Apple Park Way`. |
| `data.zip` | string | no | Postal or ZIP code. Example: `95014`. |
| `data.phone` | string | no | Primary contact phone number. Example: `(408) 996-1010`. |
| `data.website` | string (uri) | no | Company website URL. Example: `https://www.apple.com`. |
| `data.exchange` | string | no | Full name of the listing exchange. Example: `NASDAQ Global Select`. |
| `data.exchangeShortName` | string | no | Abbreviated exchange name. Example: `NASDAQ`. |
| `data.isin` | string | no | International Securities Identification Number. Example: `US0378331005`. |
| `data.cik` | string \| null | no | SEC Central Index Key. Example: `320193`. |
| `data.ipo` | string (date) \| null | no | Initial public offering date. Example: `1980-12-12`. |
| `data.currency` | string | no | Primary trading currency (ISO 4217) Example: `USD`. |
| `data.employeeTotal` | integer \| null | no | Total number of employees. Example: `164000`. |
| `data.isActivelyTrading` | boolean | no | Whether the security is currently actively traded. Example: `true`. |
| `data.isAdr` | boolean | no | Whether the security is an American Depositary Receipt. Example: `false`. |
| `data.isReit` | boolean \| null | no | 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`. |
| `meta` | ResponseMeta | no | 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. |
| `meta.time` | integer | no | Server-side processing time in milliseconds. Example: `17`. |
| `meta.parameters` | object | no | Echo of the request parameters the endpoint resolved. |

## Example request

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

## Example response

```json
{
  "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
  }
}
```

## Errors

| Status | Meaning |
|---|---|
| 400 | Invalid 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). |
| 401 | Missing or invalid API key. |
| 404 | Resource not found. |
| 429 | Rate limit exceeded. Retry after the `Retry-After` header interval. |
| 500 | An unexpected error occurred on the server. If the issue persists, contact support with the X-Request-Id header value. |
| 502 | Upstream data provider returned an error or is temporarily unavailable. Retry after a short delay. |
| 504 | The request timed out waiting for a response from the upstream data provider. This may occur for complex queries or during peak load. |
| default | An unexpected error occurred on the server. If the issue persists, contact support with the X-Request-Id header value. |

- `403` from the gateway: the API key is invalid or switched off.
- `429` with message `Limit Exceeded`: the monthly quota of the key is used up. With `Too Many Requests`: the key is throttled, or this route is not in the key's plan. Wait for `Retry-After` when it is sent.

## Links

- HTML page: https://dashboard.bavest.co/docs/v2_equities_profile
- OpenAPI: https://dashboard.bavest.co/openapi.json (YAML: https://dashboard.bavest.co/openapi.yaml)
- Authentication: https://dashboard.bavest.co/docs/authentication.md
- MCP server for AI agents: https://dashboard.bavest.co/docs/mcp.md
- All routes: https://dashboard.bavest.co/llms.txt