# Company Profile (Ticker)

`GET` `/v1/companydata/tickers/{ticker}`

Retrieve comprehensive reference and profile data for a single ticker. The response includes company or fund name, exchange, sector, industry, country, CEO, employee count, website, CIK and a business description - everything you need to label a ticker in a UI or enrich analytics without a separate fundamentals call. Pass any supported ticker (e.g. AAPL, SPY) as the path parameter.

## Use cases

- Company research and security master enrichment
- Displaying issuer context next to quotes or portfolio holdings
- Mapping tickers to CIK for SEC filing workflows
- Due diligence and compliance reference lookups

## Input parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `ticker` | string | Yes | Ticker, e.g. AAPL. |

## Output parameters

| Name | Type | Description |
| --- | --- | --- |
| `ticker` | string | Ticker. |
| `company` | string | Company or fund name. |
| `sector` | string | GICS sector when available. |
| `industry` | string | Industry classification. |
| `exchange` | string | Primary listing exchange. |
| `exchangeShort` | string | Short exchange code. |
| `country` | string | Country of incorporation or domicile. |
| `etf` | boolean | True when the ticker is an ETF. |
| `fund` | boolean | True when the ticker is a mutual fund. |
| `cik` | string | SEC Central Index Key. |
| `isin` | string | International Securities Identification Number. |
| `cusip` | string | CUSIP identifier. |
| `website` | string | Issuer website URL. |
| `description` | string | Business description or fund summary. |
| `ceo` | string | Chief executive officer when available. |
| `employees` | string | Employee count when available. |
| `phone` | string | Company phone number. |
| `address` | string | Street address. |
| `city` | string | City. |
| `state` | string | State or region. |
| `zip` | string | Postal code. |
| `ipo` | string | IPO date (YYYY-MM-DD) when known. |

## Example response

```json
{
  "ticker": "AAPL",
  "company": "Apple Inc.",
  "sector": "Technology",
  "industry": "Consumer Electronics",
  "exchange": "NASDAQ Global Select",
  "exchangeShort": "NASDAQ",
  "country": "US",
  "etf": false,
  "fund": false,
  "cik": "0000320193",
  "isin": "US0378331005",
  "cusip": "037833100",
  "website": "https://www.apple.com",
  "description": "Apple Inc. designs, manufactures, and markets smartphones, personal computers, tablets, wearables, and accessories worldwide. The company offers iPhone, a line of smartphones; Mac, a line of personal computers; iPad, a l...",
  "ceo": "Timothy D. Cook",
  "employees": "164000",
  "phone": "(408) 996-1010",
  "address": "One Apple Park Way",
  "city": "Cupertino",
  "state": "CA",
  "zip": "95014",
  "ipo": "1980-12-12"
}
```

## Examples

### cURL

```bash
curl "https://api.vantafin.com/v1/companydata/tickers/AAPL?apiKey=$VANTAFIN_API_KEY"
```

### Python

```python
from vantafin import RESTClient

client = RESTClient("vf-live-your_api_key")

result = client.get_ticker("AAPL")

print(result)
```

### JavaScript

```javascript
import { RestClient } from "vantafin";

const client = new RestClient("vf-live-your_api_key");

const result = await client.getTicker("AAPL");

console.log(result);
```

### Go

```go
package main

import (
	"fmt"
	"log"

	"github.com/vantafin/vantafin-go"
)

func main() {
	client := vantafin.NewClient("vf-live-your_api_key")

	result, err := client.GetTicker("AAPL")
	if err != nil {
		log.Fatal(err)
	}

	fmt.Println(result)
}
```

### Java

```java
import com.vantafin.RestClient;

public class Example {
    public static void main(String[] args) throws Exception {
        RestClient client = new RestClient("vf-live-your_api_key");

        Object result = client.getTicker("AAPL");

        System.out.println(result);
    }
}
```

### Ruby

```ruby
require "vantafin"

client = Vantafin::RestClient.new("vf-live-your_api_key")

result = client.get_ticker("AAPL")

pp result
```