# Company Profile (CUSIP)

`GET` `/v1/companydata/cusips/{cusip}`

Retrieve the same company or ETF profile as Company Profile (Ticker), but lookup by CUSIP. Pass the 9-character CUSIP (e.g. 037833100). When multiple share classes share an identifier, returns the canonical listing.

## Use cases

- Enriching US holdings and fund accounting records keyed by CUSIP
- Mapping CUSIP from custodian files to issuer context and ticker
- Compliance and reference lookups when only CUSIP is known
- Building security master records from CUSIP-based security lists

## Input parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `cusip` | string | Yes | CUSIP identifier, e.g. 037833100. |

## 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/cusips/037833100?apiKey=$VANTAFIN_API_KEY"
```

### Python

```python
from vantafin import RESTClient

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

result = client.get_company_by_cusip("037833100")

print(result)
```

### JavaScript

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

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

const result = await client.getCompanyByCusip("037833100");

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.GetCompanyByCusip("037833100")
	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.getCompanyByCusip("037833100");

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

### Ruby

```ruby
require "vantafin"

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

result = client.get_company_by_cusip("037833100")

pp result
```