Company Profile (ISIN)
GET/v1/companydata/isins/{isin}
Retrieve the same company or ETF profile as Company Profile (Ticker), but lookup by International Securities Identification Number (ISIN). Pass the 12-character ISIN (e.g. US0378331005). When multiple share classes share an identifier, returns the canonical listing.
Use cases
- Enriching cross-border holdings and custody records keyed by ISIN
- Mapping European and global security identifiers to issuer context
- Compliance and reference lookups when only ISIN is known
- Building security master records from portfolio ISIN lists
Input parameters
Required
| Parameter | Type | Description |
|---|---|---|
| isin(*) | string | International Securities Identification Number, e.g. US0378331005. |
Output parameters
| Field | 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. |
from vantafin import RESTClient
client = RESTClient("vf-live-your_api_key")
result = client.get_company_by_isin("US0378331005")
print(result){
"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"
}