Available via: REST API · MCP · n8n · Make
This endpoint retrieves descriptive profile data for a single stock, ETF, or mutual fund, including contact details, sector and industry, business or fund description, key officers and governance scores for companies, and style, size, and fee details for funds.
Coverage
| Asset Types | Stocks, ETFs, mutual funds |
| Market Regions | ~54 |
| Listings | ~360,000 |
Coverage figures are approximate and may change over time.
Data Freshness
Data is returned as a snapshot. The time of the latest update is indicated by update_time and varies between assets.
Asset Type Compatibility
This endpoint uses one response schema for stocks, ETFs, and mutual funds. Available data depends on the asset type:
- Stocks: address and contact details, sector and industry, business summary, employee count, key officers with compensation, and governance risk scores where available.
- ETFs: fund description, style box and size/style classification, net assets, YTD return, yield, expense ratio, and holdings turnover.
- Mutual funds: fund description, style box and size/style classification, net assets, YTD return, yield, last distributions, Morningstar rating, and expense ratios.
Data Availability & Limitations
Some fields may return null, an empty string, or an empty array if a specific value is not available for a given asset. This does not indicate an error. Some numeric fields may also return 0 when no value is available (e.g., fees_expense_projection_3yr).
When to Use This Endpoint
- Build company profile pages for financial data platforms and research apps.
- Add leadership and executive overviews to equity research tools.
- Power fund research and fund comparison tools.
- Enrich portfolio trackers and watchlists with company and fund background information.
- Provide context for AI assistants and research copilots answering questions about specific assets.
Request Parameters
v1/profile
Asset identifier (ticker symbol).
User-defined identifier for the task (max 255 characters).
It is returned in the response data object, allowing you to match results with the corresponding request. It does not affect API processing or filtering logic.
curl --location "https://api.finimpulse.com/v1/profile" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <API_TOKEN>" \
-d '{
"symbol": "NVDA",
"tag": "just tag"
}'
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
var client = new HttpClient();
var url = "https://api.finimpulse.com/v1/profile";
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "<API_TOKEN>");
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
var json = @"{
""symbol"": ""NVDA"",
""tag"": ""just tag""
}";
var content = new StringContent(json, Encoding.UTF8, "application/json");
var response = await client.PostAsync(url, content);
var result = await response.Content.ReadAsStringAsync();
Console.WriteLine(result);
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.finimpulse.com/v1/profile",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"Authorization: Bearer <API_TOKEN>"
],
CURLOPT_POSTFIELDS => json_encode(
[
"symbol" => "NVDA",
"tag" => "just tag"
]
)
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;
import urllib.request
import json
url = "https://api.finimpulse.com/v1/profile"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer <API_TOKEN>"
}
data = {
"symbol": "NVDA",
"tag": "just tag"
}
req = urllib.request.Request(url,
data=json.dumps(data).encode("utf-8"),
headers=headers,
method="POST")
with urllib.request.urlopen(req) as response:
result = json.loads(response.read().decode("utf-8"))
print(result)
const https = require('https');
const data = JSON.stringify({
"symbol": "NVDA",
"tag": "just tag"
});
const options = {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer <API_TOKEN>',
'Content-Length': Buffer.byteLength(data)
}
};
const req = https.request('https://api.finimpulse.com/v1/profile', options, (res) => {
let body = '';
res.on('data', chunk => body += chunk);
res.on('end', () => console.log(JSON.stringify(JSON.parse(body), null, 2)));
});
req.on('error', (e) => console.error(e));
req.write(data);
req.end();
Response
The response returns an items array with a single profile record for the requested symbol.
Pagination Fields
Total number of matching items.
Array of profile records. Typically a single item for the requested symbol.
General Information
Asset identifier (ticker symbol).
Asset class identifier (stock, etf, mutualfund).
Trading currency.
Address and Contact Details
Address line 1 (or primary address string when provided as a single line).
City.
State or region.
Postal code.
Country.
Primary phone number.
Official website URL.
Sector and Industry
Industry classification.
Normalized industry key.
Display-friendly industry label.
Sector classification.
Normalized sector key.
Display-friendly sector label.
Business/Fund Description
Long-form company description (stocks) or investment objective summary (funds).
Company Size & People
Number of full-time employees.
Array of company officer records.
Officer name.
Officer age.
Officer role.
Birth year.
Fiscal year for record.
Total compensation for the fiscal year.
Exercised value.
Governance Dates & Links
Governance dataset reference date.
Compensation dataset reference date.
Investor relations website URL.
Governance Risk Indicators
Governance audit risk score.
Governance board risk score.
Governance compensation risk score.
Governance shareholder rights risk score.
Overall governance risk score.
Fund Style & Classification
Style box image URL.
Size classification (e.g., large, medium).
Investment valuation style classification (e.g., value, blend).
Fund Size & Distribution
Total net assets under management.
Year-to-date (YTD) return.
Fund distribution yield.
Last dividend amount.
Last capital gains distribution amount.
Morningstar rating.
Fees & Expenses
Annual report expense ratio.
Annual holdings turnover.
Total net assets.
Net expense ratio.
Gross expense ratio.
12b-1 distribution fee.
Front-end sales load.
Deferred sales load.
Projected cumulative expenses over 3 years.
Projected cumulative expenses over 5 years.
Projected cumulative expenses over 10 years.
Category average annual report expense ratio.
Category average annual holdings turnover.
Category average total net assets.
Category average net expense ratio.
Category average gross expense ratio.
Category average 12b-1 distribution fee.
Category average front-end sales load.
Category average deferred sales load.
Category average projected cumulative expenses over 3 years.
Category average projected cumulative expenses over 5 years.
Category average projected cumulative expenses over 10 years.
Metadata
Timestamp of the most recent data update (ISO 8601).
{
"result": {
"total_count": 1,
"items": [
{
"symbol": "NVDA",
"quote_type": "stock",
"currency": "USD",
"address_1": "2788 San Tomas Expressway",
"city": "Santa Clara",
"state": "CA",
"zip": "95051",
"country": "United States",
"phone": "408 486 2000",
"website": "https://www.nvidia.com",
"industry": "Semiconductors",
"industry_key": "semiconductors",
"industry_disp": "Semiconductors",
"sector": "Technology",
"sector_key": "technology",
"sector_disp": "Technology",
"long_business_summary": "NVIDIA Corporation, a computing infrastructure company, provides graphics and compute and networking solutions in the United States, Singapore, Taiwan, China, Hong Kong, and internationally. The Compute & Networking segment includes its Data Centre accelerated computing platforms and artificial intelligence solutions and software; networking; automotive platforms and autonomous and electric vehicle solutions; Jetson for robotics and other embedded platforms; and DGX Cloud computing services. The Graphics segment offers GeForce GPUs for gaming and PCs, the GeForce NOW game streaming service and related infrastructure, and solutions for gaming platforms; Quadro/NVIDIA RTX GPUs for enterprise workstation graphics; virtual GPU or vGPU software for cloud-based visual and virtual computing; automotive platforms for infotainment systems; and Omniverse software for building and operating industrial AI and digital twin applications. It also customized agentic solutions designed in collaboration with NVIDIA to accelerate enterprise AI adoption. The company's products are used in gaming, professional visualization, data center, and automotive markets. It sells its products to original equipment manufacturers, original device manufacturers, system integrators and distributors, independent software vendors, cloud service providers, consumer internet companies, add-in board manufacturers, distributors, automotive manufacturers and tier-1 automotive suppliers, and other ecosystem participants. The company has a strategic partnership with Siemens Aktiengesellschaft to develop industrial and physical AI solutions for AI-driven innovation to every industry and industrial workflow. NVIDIA Corporation was incorporated in 1993 and is headquartered in Santa Clara, California.",
"full_time_employees": 36000,
"company_officers": [
{
"name": "Mr. Jen-Hsun Huang",
"age": 62,
"title": "Co-Founder, CEO, President & Director",
"year_born": 1963,
"fiscal_year": 2025,
"total_pay": 11054945,
"exercised_value": 0
},
{
"name": "Ms. Colette M. Kress",
"age": 58,
"title": "Executive VP & CFO",
"year_born": 1967,
"fiscal_year": 2025,
"total_pay": 1512641,
"exercised_value": 0
},
{
"name": "Ms. Debora Shoquist",
"age": 70,
"title": "Executive Vice President of Operations",
"year_born": 1955,
"fiscal_year": 2025,
"total_pay": 1379071,
"exercised_value": 0
},
{
"name": "Mr. Timothy S. Teter J.D.",
"age": 58,
"title": "Executive VP, General Counsel & Secretary",
"year_born": 1967,
"fiscal_year": 2025,
"total_pay": 1362989,
"exercised_value": 0
},
{
"name": "Mr. Ajay K. Puri",
"age": 70,
"title": "Executive Vice President of Worldwide Field Operations",
"year_born": 1955,
"fiscal_year": 2025,
"total_pay": 2313851,
"exercised_value": 0
},
{
"name": "Mr. Chris A. Malachowsky",
"age": null,
"title": "Co-Founder",
"year_born": null,
"fiscal_year": 2025,
"total_pay": 320000,
"exercised_value": 0
},
{
"name": "Mr. Donald F. Robertson Jr.",
"age": 56,
"title": "VP & Chief Accounting Officer",
"year_born": 1969,
"fiscal_year": 2025,
"total_pay": null,
"exercised_value": 0
},
{
"name": "Prof. William J. Dally Ph.D.",
"age": 64,
"title": "Chief Scientist & Senior VP of Research",
"year_born": 1961,
"fiscal_year": 2025,
"total_pay": null,
"exercised_value": 0
},
{
"name": "Mr. Toshiya Hari",
"age": null,
"title": "Vice President of Investor Relations & Strategic Finance",
"year_born": null,
"fiscal_year": 2025,
"total_pay": null,
"exercised_value": 0
},
{
"name": "Ms. Mylene Mangalindan",
"age": null,
"title": "VP of Corporate Communications",
"year_born": null,
"fiscal_year": 2025,
"total_pay": null,
"exercised_value": 0
}
],
"governance_epoch_date": "2026-02-01T00:00:00Z",
"compensation_as_of_epoch_date": "2025-12-31T00:00:00Z",
"ir_website": "http://phx.corporate-ir.net/phoenix.zhtml?c=116466&p=irol-IRHome",
"governance_audit_risk": 5,
"governance_board_risk": 9,
"governance_compensation_risk": 4,
"governance_shareholder_rights_risk": 8,
"governance_overall_risk": 8,
"style_box_url": "",
"company_size": null,
"investment_valuation_style": null,
"net_assets": null,
"ytd_return": null,
"yield": null,
"last_dividend": 0.01,
"last_cap_gain": null,
"morning_star_rating": null,
"fees_annual_report_expense_ratio": null,
"fees_annual_holdings_turnover": null,
"fees_total_net_assets": null,
"fees_net_exp_ratio": null,
"fees_gross_exp_ratio": null,
"fees_twelve_b_one": null,
"fees_front_end_sales_load": null,
"fees_deferred_sales_load": null,
"fees_expense_projection_3yr": null,
"fees_expense_projection_5yr": null,
"fees_expense_projection_10yr": null,
"fees_annual_report_expense_ratio_cat": null,
"fees_annual_holdings_turnover_cat": null,
"fees_total_net_assets_cat": null,
"fees_net_exp_ratio_cat": null,
"fees_gross_exp_ratio_cat": null,
"fees_twelve_b_one_cat": null,
"fees_front_end_sales_load_cat": null,
"fees_deferred_sales_load_cat": null,
"fees_expense_projection_3yr_cat": null,
"fees_expense_projection_5yr_cat": null,
"fees_expense_projection_10yr_cat": null,
"update_time": "2026-02-03T14:02:10Z"
}
]
}
}Units and Formats
Percent-like fields are returned as decimal values (e.g., 0.0095 represents 0.95%), including ytd_return, yield, expense ratios, holdings turnover, and sales loads.
Related APIs
- Summary Data API for Stocks, ETFs & Mutual Funds
- Lightweight Summary API for Stocks, ETFs & Mutual Funds
- Search API for Stocks, ETFs, Mutual Funds & Indices
- Market Price API for Stocks, ETFs & Mutual Funds
- Company Insider Roster & Activity API
- Institutional & Insider Ownership API for Stocks
- ETF & Mutual Fund Holdings Overview API
- ETF & Mutual Fund Annual Returns API
- Financial News API for Stocks, ETFs, Mutual Funds & Indices
