Company Data
Returns detailed, structured data on a specific company, identified by its exchange and ticker.
The response always includes basic company info (info
) and can be expanded with additional data blocks via the include
parameter.
Use this endpoint to access the complete company profile, including fundamentals, financials, insider activity, dividends, operations, ownership, and investment ideas.
API Reference
Method | Path | Description |
---|---|---|
GET |
/v2/stocks/{exchange}:{code} |
Retrieve detailed data for a specific company |
Query Parameters
Key | Type | Location | Required | Description |
---|---|---|---|---|
exchange |
string | path | ✅ | Exchange code (e.g. MOEX , KASE ) |
code |
string | path | ✅ | Company ticker (e.g. GAZP ) |
include |
string | query | ❌ | Comma-separated list of data blocks to include |
Base Model Schema
{
"info": { ... },
"summary": { ... },
"ratios": [ ... ],
"reports": [ ... ],
"dividends": [ ... ],
"insiderTransactions": [ ... ],
"owners": [ ... ],
"shares": [ ... ],
"operations": [ ... ]
}
info
is always included- Other blocks are included only if explicitly listed in the
include
parameter
Info
(always included)
Basic company profile: general identifiers, classification (industry, sector), listing info, report frequency, and website.
Field | Type | Description |
---|---|---|
changed_at |
string (ISO) | Last update timestamp |
code |
string | Ticker symbol (e.g. GAZP ) |
country |
string | Country of incorporation/listing |
currency |
string | Trading currency |
description |
string | Short company description |
disc_link |
string (URL) | Link to disclosure page |
exchange |
string | Exchange code (e.g. MOEX ) |
industry |
string | Industry classification |
industry_group |
string | Industry group name |
industry_group_id |
integer | Industry group ID |
industry_id |
integer | Industry ID |
name |
string | Full company name |
primary_report_code |
string | Ticker used in financial reports |
primary_report_exchange |
string | Exchange used in reports |
report_frequency |
string | Reporting frequency (quarterly , annual , etc.) |
sector |
string | Sector name |
sector_id |
integer | Sector ID |
site |
string (URL) | Official website |
spb |
boolean | Listed on SPB Exchange (true or false ) |
sub_industry |
string | Sub-industry name |
sub_industry_id |
integer | Sub-industry ID |
Summary
High-level growth, dividend, and consensus snapshot: valuation potential (PEG, targets), dividend history stats, 3–5 year growth rates, and analyst sentiment.
Field | Type | Description |
---|---|---|
capital |
number | Market capitalization |
changed_at |
string | Last update timestamp (ISO 8601) |
dividend_frequency |
integer | Number of dividend payouts per year |
dividend_gap_average |
integer | Average gap close duration after dividend, in days |
dividend_gap_last |
integer | Last observed gap close duration, in days |
dividend_growth |
integer | Consecutive years of dividend growth |
dividend_index |
number | Dividend attractiveness index |
dividend_strike |
integer | Number of years dividends were paid without interruption |
dividend_yield_12m |
number | Trailing 12-month dividend yield (%) |
dividend_yield_3y |
number | 3-year average dividend yield (%) |
dividend_yield_5y |
number | 5-year average dividend yield (%) |
eps |
number | Earnings per share |
graham_target |
number | Target price based on Graham formula |
growth_assets_3y |
number | 3-year average growth in assets (%) |
growth_assets_5y |
number | 5-year average growth in assets (%) |
growth_earnings_3y |
number | 3-year average earnings growth (%) |
growth_earnings_5y |
number | 5-year average earnings growth (%) |
growth_ebitda_3y |
number | 3-year average EBITDA growth (%) |
growth_ebitda_5y |
number | 5-year average EBITDA growth (%) |
growth_equity_3y |
number | 3-year average equity growth (%) |
growth_equity_5y |
number | 5-year average equity growth (%) |
growth_fcf_3y |
number | 3-year average free cash flow growth (%) |
growth_fcf_5y |
number | 5-year average free cash flow growth (%) |
growth_netdebt_3y |
number | 3-year average change in net debt (%) |
growth_netdebt_5y |
number | 5-year average change in net debt (%) |
growth_operation_3y |
number | 3-year average operating profit growth (%) |
growth_operation_5y |
number | 5-year average operating profit growth (%) |
growth_revenue_3y |
number | 3-year average revenue growth (%) |
growth_revenue_5y |
number | 5-year average revenue growth (%) |
idea_buy |
integer | Number of active "buy" recommendations |
idea_consensus |
string | Consensus rating (buy , hold , sell ) |
idea_hold |
integer | Number of active "hold" recommendations |
idea_potential |
number | Average expected upside (%) from consensus |
idea_sell |
integer | Number of active "sell" recommendations |
idea_target |
number | Consensus target price |
insider_consensus |
string | General insider sentiment (e.g. bullish , neutral ) |
peg |
number | PEG ratio |
peter_lynch_target |
number | Target price based on Peter Lynch's method |
Dividends
List of historical and upcoming dividends: amount, yield, dates (last buy, registry close), and dividend type.
Field | Type | Description |
---|---|---|
changed_at |
string (ISO) | Last update timestamp |
code |
string | Ticker symbol (e.g. GAZP ) |
div_amount |
number | Dividend amount per share |
div_curr |
string | Dividend currency (e.g. RUB ) |
div_percent |
number | Dividend yield (%) |
exchange |
string | Exchange code (e.g. MOEX ) |
last_buy_date |
string (date) | Last day to purchase shares to receive dividend |
last_buy_price |
number | Share price on last buy date |
link |
string (URL) | Source link |
reestr_close_date |
string (date) | Registry close date (ex-dividend date) |
type |
string | Type of dividend (e.g. regular, interim) |
year |
integer | Year the dividend was declared |
Ratios
Financial ratios and valuation metrics by reporting period: P/E, ROE, EV/EBITDA, margins, debt ratios, etc.
Field | Type | Description |
---|---|---|
active |
boolean | Whether this is the latest period |
capex_revenue |
number | CAPEX to Revenue ratio |
capital |
number | Market capitalization |
changed_at |
string (ISO) | Last update timestamp |
code |
string | Ticker symbol (e.g. GAZP ) |
current_ratio |
number | Current Ratio |
debt_equity |
number | Debt-to-Equity ratio |
debt_ratio |
number | Debt Ratio |
debtebitda |
number | Debt to EBITDA |
dpr |
number | Dividend Payout Ratio (deprecated) |
ebitda_margin |
number | EBITDA margin (%) |
ev_ebit |
number | EV/EBIT |
evebitda |
number | EV/EBITDA |
evs |
number | EV/Sales (EV/S) |
exchange |
string | Exchange code (e.g. MOEX ) |
gross_margin |
number | Gross margin (%) |
interest_coverage |
number | Interest Coverage Ratio |
month |
integer | Reporting month |
net_margin |
number | Net margin (%) |
net_working_capital |
number | Net Working Capital Ratio |
netdebt_ebitda |
number | Net Debt to EBITDA |
operation_margin |
number | Operating margin (%) |
pbv |
number | Price to Book Value (P/BV) |
pcf |
number | Price to Cash Flow (P/CF) |
pe |
number | Price to Earnings (P/E) |
period |
string | Reporting period (e.g. 2023Q2 ) |
pfcf |
number | Price to Free Cash Flow (P/FCF) |
pffo |
number | Price to Funds From Operations (P/FFO) |
ps |
number | Price to Sales (P/S) |
roa |
number | Return on Assets (ROA) |
roce |
number | Return on Capital Employed (ROCE) |
roe |
number | Return on Equity (ROE) |
roic |
number | Return on Invested Capital (ROIC) |
ros |
number | Return on Sales (ROS) |
type |
string | Report type (annual , quarterly , etc.) |
year |
integer | Reporting year |
Reports
Detailed financial statements for each reporting period: income statement, balance sheet, cash flow, capital expenditures, and liquidity indicators.
Field | Type | Description |
---|---|---|
accounts_payable |
integer | Total accounts payable |
accounts_payable_current |
integer | Current accounts payable |
accounts_payable_long |
integer | Long-term accounts payable |
accounts_receivable |
integer | Total accounts receivable |
accounts_receivable_current |
integer | Current accounts receivable |
accounts_receivable_long |
integer | Long-term accounts receivable |
amount |
integer | Unit multiplier (e.g. values in thousands) |
capex |
integer | Capital expenditures |
cash_and_equiv |
integer | Cash and equivalents |
cash_paid_for_interest |
integer | Interest paid (cash flow) |
cff |
integer | Cash flow from financing activities |
cfi |
integer | Cash flow from investing activities |
cfo |
integer | Cash flow from operating activities |
changed_at |
string | Last update timestamp |
code |
string | Ticker symbol (e.g. GAZP) |
commission_expense |
integer | Commission expenses |
commission_income |
integer | Commission income |
commission_net |
integer | Net commission income |
cost_of_sales |
integer | Cost of goods sold |
cur_long_debt |
integer | Total debt (short + long term) |
cur_long_lease |
integer | Total lease obligations |
curr |
string | Currency |
current_assets |
integer | Current assets |
current_debt |
integer | Current debt |
current_lease |
integer | Current lease obligations |
current_liabilities |
integer | Current liabilities |
depr_depl_amort |
integer | Depreciation, depletion and amortization |
earnings |
integer | Net income |
earnings_ps |
number | Earnings per share |
earnings_stock_holders |
integer | Earnings attributable to shareholders |
earnings_wo_tax |
integer | Earnings before tax |
ebit |
integer | Earnings before interest and taxes |
ebitda |
integer | EBITDA |
ebitda_ps |
number | EBITDA per share |
equity |
integer | Total equity |
equity_ps |
number | Equity per share |
equity_stock_holders |
integer | Shareholder equity |
exchange |
string | Exchange code (e.g. MOEX) |
fcf |
integer | Free cash flow |
fcf_ps |
number | Free cash flow per share |
ffo |
integer | Funds from operations |
goodwill |
integer | Goodwill |
gross_profit |
integer | Gross profit |
intangibles_purchase |
integer | Purchase of intangible assets |
interest_expense |
integer | Interest expense |
interest_income |
integer | Interest income |
interest_net |
integer | Net interest |
inventories |
integer | Inventories |
issuance_of_debt |
integer | New debt issued |
link |
string (URL) | Source link to the report |
link_press |
string (URL) | Link to investor presentation |
link_update |
string (URL) | Link to updated report |
long_term_assets |
integer | Non-current assets |
long_term_debt |
integer | Long-term debt |
long_term_investments |
integer | Long-term investments |
long_term_lease |
integer | Long-term lease liabilities |
long_term_liabilities |
integer | Long-term liabilities |
month |
integer | Reporting month |
net_debt |
integer | Net debt |
net_issuance_of_debt |
integer | Net debt repayment |
operating_income |
integer | Operating income |
payments_for_dividends |
integer | Dividend payments |
payments_of_debt |
integer | Debt repayments |
period |
string | Reporting period (e.g. 2023Q2 ) |
ppe_purchase |
integer | Purchase of property, plant & equipment |
preliminary |
boolean | Whether the report is preliminary |
property_plant_equipment |
integer | Book value of PPE |
repurchase_of_stock |
integer | Share buybacks |
research_and_development |
integer | R&D expenses |
retained_earnings |
integer | Retained earnings |
revenue |
integer | Revenue |
revenue_ps |
number | Revenue per share |
sel_gen_adm_expenses |
integer | SG&A expenses |
share_premium |
integer | Share premium |
total_assets |
integer | Total assets |
total_debt |
integer | Total debt |
total_expenses |
integer | Total operating expenses |
total_liabilities |
integer | Total liabilities |
type |
string | Report type (e.g. annual, quarterly) |
year |
integer | Reporting year |
InsiderTransactions
List of insider trades: buy/sell actions, transaction dates, amounts, prices, and changes in ownership.
Field | Type | Description |
---|---|---|
amount |
number | Number of shares involved in the transaction |
approximate |
boolean | Whether the transaction data is an approximation |
changed_at |
string (ISO) | Last update timestamp |
code |
string | Ticker symbol (e.g. GAZP ) |
exchange |
string | Exchange code (e.g. MOEX ) |
filling_date |
string (date) | Date the transaction was disclosed |
link |
string (URL) | Source link to the disclosure |
own_after |
number | Ownership percentage after the transaction |
own_before |
number | Ownership percentage before the transaction |
owner |
string | Name of the insider |
owner_title |
string | Insider’s title or position |
price |
number | Price per share |
shares_after |
number | Number of shares held after the transaction |
shares_before |
number | Number of shares held before the transaction |
transaction_date |
string (date) | Date when the transaction took place |
transaction_type |
string | Type of transaction (e.g. buy, sell) |
value |
number | Total value of the transaction |
Ideas
Investment ideas and target scenarios from broker communities or analysts: entry/target prices, expected profit, and community name.
Field | Type | Description |
---|---|---|
changed_at |
string (ISO) | Last update timestamp |
close_comment |
string | Reason for closing the idea |
close_date |
string (date) | Date when the idea was closed |
close_link |
string (URL) | Link to the closure source |
close_price |
number | Closing price of the idea |
code |
string | Ticker symbol (e.g. GAZP ) |
community |
string | Name of the community that published the idea |
community_id |
integer | ID of the community |
date_in |
string (date) | Entry date of the idea |
date_out |
string (date) | Planned exit date |
duration_in_month |
integer | Duration in months |
exchange |
string | Exchange code (e.g. MOEX ) |
id |
integer | Unique idea ID |
idea |
string | Title of the investment idea |
link |
string (URL) | Source link |
price_day |
number | Current market price |
price_in |
number | Entry price |
price_out |
number | Target price |
profit_actual |
number | Realized return at closing |
profit_potential |
number | Projected annualized return |
stop_loss |
number | Stop-loss level |
system_status |
string | Current status (e.g. open, closed, hold) |
update_comment |
string | Reason for update |
update_date |
string (date) | Date of last update |
update_link |
string (URL) | Source link for the update |
update_price |
number | Updated target price |
Owners
Major shareholders data: who owns how much of the company over time, typically by year/month.
Field | Type | Description |
---|---|---|
changed_at |
string (ISO) | Last update timestamp |
code |
string | Ticker symbol (e.g. GAZP ) |
exchange |
string | Exchange code (e.g. MOEX ) |
link |
string (URL) | Source link |
month |
integer | Month of the ownership record |
own |
string | Ownership share (e.g. 15.24% ) |
owner |
string | Name of the shareholder |
year |
integer | Year of the ownership record |
Shares
Share count over time: number of shares outstanding by month or year — useful for dilution analysis or per-share metrics.
Field | Type | Description |
---|---|---|
changed_at |
string (ISO) | Last update timestamp |
code |
string | Ticker symbol (e.g. GAZP ) |
exchange |
string | Exchange code (e.g. MOEX ) |
month |
integer | Month of the share record |
num |
integer | Number of shares |
year |
integer | Year of the share record |
Operations
Operational metrics (if available): standardized indicators like production volume, reserves, consumption, etc., by period.
Field | Type | Description |
---|---|---|
amount |
integer | Standardized value multiplier (e.g. 1000 ) |
code |
string | Ticker symbol (e.g. GAZP ) |
curs |
number | Conversion rate between original and standardized units |
exchange |
string | Exchange code (e.g. MOEX ) |
link |
string (URL) | Source link |
link_update |
string (URL) | Update source link |
month |
integer | Month of the operational data |
operation_metric_id |
string | Operation metric code (e.g. gold_produced ) |
original_amount |
integer | Original value multiplier (e.g. 1000 ) |
original_unit |
string | Original unit (e.g. oz ) |
original_value |
number | Original reported value |
period |
string | Reporting period |
unit |
string | Standardized unit (e.g. oz ) |
value |
number | Standardized value |
year |
integer | Year of the operational data |
Use Cases 1: Basic info
Scenario
A client wants to retrieve basic company profile data — such as name, industry, exchange, and description — for display or lookup purposes. No additional data blocks are requested.
Request
GET /v2/stocks/MOEX:GAZP?token=<YOUR_API_TOKEN>
Response
{
"info": {
"changed_at": "2025-06-25T16:20:29.461Z",
"code": "GAZP",
"country": "Russia",
"currency": "RUB",
"description": "Gazprom is a large Russian energy company engaged in the extraction, production, transport, and sale of natural gas.",
"disc_link": "https://www.e-disclosure.ru/portal/company.aspx?id=1234",
"exchange": "MOEX",
"industry": "Oil & Gas Exploration and Production",
"industry_group": "Energy",
"industry_group_id": 101,
"industry_id": 1001,
"name": "Gazprom",
"primary_report_code": "GAZP",
"primary_report_exchange": "MOEX",
"report_frequency": "Annual",
"sector": "Energy",
"sector_id": 10,
"site": "https://www.gazprom.ru",
"spb": true,
"sub_industry": "Integrated Oil & Gas",
"sub_industry_id": 10001
}
}
Use Cases 2: Fundamentals
Scenario
A client is evaluating the company's valuation metrics and fundamentals, such as P/E ratios, margins, and financial statements. They include ratios
, reports
, and summary
in the request to build a detailed analytics dashboard.
Request
GET /v2/stocks/MOEX:GAZP?include=ratios,reports,summary&token=<YOUR_API_TOKEN>
Response
{
"info": {...},
"ratios": [
{
"code": "GAZP",
"exchange": "MOEX",
"year": 2024,
"period": "12M",
"pe": 4.8,
"pbv": 0.6,
"roe": 18.2,
"gross_margin": 45.1,
"ebitda_margin": 33.4,
"changed_at": "2025-06-20T12:00:00Z",
...
},
...
],
"reports": [
{
"code": "GAZP",
"exchange": "MOEX",
"year": 2024,
"period": "12M",
"revenue": 1020000000,
"earnings": 210000000,
"ebitda": 340000000,
"equity": 1600000000,
"total_assets": 2500000000,
"total_liabilities": 900000000,
"cash_and_equiv": 180000000,
"changed_at": "2025-06-21T08:10:00Z",
...
},
...
],
"summary": {
"capital": 640000000000,
"dividend_yield_12m": 8.1,
"peg": 0.5,
"idea_consensus": "buy",
"idea_potential": 22.4,
"eps": 20.5,
"growth_revenue_3y": 7.2,
"growth_earnings_3y": 12.6,
"dividend_growth": 4,
"changed_at": "2025-06-23T14:30:00Z",
...
}
}
Use Cases 3: Dividends & Insiders
Scenario
An investor wants to explore a company’s dividend track record along with recent insider buying and selling activity to assess potential market signals.
Request
GET /v2/stocks/MOEX:GAZP?include=dividends,insider_transactions&token=<YOUR_API_TOKEN>
Response
{
"info": {...},
"dividends": [
{
"code": "GAZP",
"exchange": "MOEX",
"year": 2024,
"div_amount": 52.3,
"div_curr": "RUB",
"div_percent": 9.8,
"last_buy_date": "2024-06-25",
"reestr_close_date": "2024-06-27",
"type": "final",
"link": "https://www.gazprom.ru/disclosure/dividends",
"changed_at": "2025-06-20T10:45:00Z"
},
...
],
"insiderTransactions": [
{
"code": "GAZP",
"exchange": "MOEX",
"transaction_date": "2025-04-02",
"filling_date": "2025-04-04",
"owner": "Ivan Ivanov",
"owner_title": "Board Member",
"transaction_type": "buy",
"amount": 100000,
"price": 158.2,
"value": 15820000,
"own_before": 0.012,
"own_after": 0.017,
"approximate": false,
"link": "https://disclosure.gazprom.ru/insider/txn/20250404",
"changed_at": "2025-06-18T09:00:00Z"
},
...
]
}
Get Your Trial Access
To use this endpoint, you need an API token.
We provide demo access within 1 business day — just contact us at api@cisfundamentals.com with a brief description of your use case.