What is the Cityfort data API?
- Read-only JSON over HTTPS: every request is a plain GET. There is no charge, no sign-up and no API key.
- Versioned: every address starts with
/api/v1/. - Every number is copied from a published Cityfort company page, which cites the filing it came from. Fields listed in a record's
calculatedare Cityfort calculations from the page's own numbers. - It covers the 175 companies with pages on this site. Amounts are in ₹ crore.
- No share prices, market values or price-based ratios.
- Open to any website: responses carry
Access-Control-Allow-Origin: *and use no cookies. - Education only. Every response carries the site's notice in
disclaimer, and the Cityfort data terms apply.
Which endpoints are there?
Every response has the same wrapper: apiVersion, market, unit, dataAsOf (the newest page update in it), terms, docs, attribution, disclaimer and data.
GET /api/v1
This index: version, endpoints, terms.
Example request
curl https://cityfort.in/api/v1Example response, from the published pages
{
"apiVersion": "1",
"market": "IN",
"unit": "₹ crore",
"dataAsOf": "2026-11-19",
"terms": "https://cityfort.in/api-terms",
"docs": "https://cityfort.in/developers",
"attribution": "Data: Cityfort (cityfort.in), from company filings. Link to the stock page when you use it.",
"disclaimer": "For learning only. Cityfort is not a SEBI-registered adviser and does not recommend buying or selling any security. Prices shown are dated and may be out of date.",
"data": {
"endpoints": [
{
"path": "/api/v1",
"about": "This index: version, endpoints, terms.",
"url": "https://cityfort.in/api/v1"
},
{
"path": "/api/v1/stocks",
"about": "Every company on this site: name, ticker, sector, page link, last update.",
"url": "https://cityfort.in/api/v1/stocks"
},
{
"path": "/api/v1/stocks/{slug}",
"about": "One company: key numbers, five years of annual results, sources.",
"url": "https://cityfort.in/api/v1/stocks/{slug}"
},
{
"path": "/api/v1/screener",
"about": "Key numbers of every company in one table (columns + rows), for filtering.",
"url": "https://cityfort.in/api/v1/screener"
},
{
"path": "/api/v1/sectors",
"about": "Sectors with the number of companies in each.",
"url": "https://cityfort.in/api/v1/sectors"
}
],
"rateLimit": "10 requests per 10 seconds and 30 requests per minute per IP address; more answers 429 with Retry-After. Repeated abuse is blocked.",
"companies": 175
}
}GET /api/v1/stocks
Every company on this site: name, ticker, sector, page link, last update.
Example request
curl https://cityfort.in/api/v1/stocksExample response, from the published pages (shortened: 2 of 175 companies shown)
{
"apiVersion": "1",
"market": "IN",
"unit": "₹ crore",
"dataAsOf": "2026-11-19",
"terms": "https://cityfort.in/api-terms",
"docs": "https://cityfort.in/developers",
"attribution": "Data: Cityfort (cityfort.in), from company filings. Link to the stock page when you use it.",
"disclaimer": "For learning only. Cityfort is not a SEBI-registered adviser and does not recommend buying or selling any security. Prices shown are dated and may be out of date.",
"data": [
{
"slug": "abb-india",
"name": "ABB India",
"ticker": "ABB",
"sector": "Capital Goods",
"sectorSlug": "capital-goods",
"template": "standard",
"url": "https://cityfort.in/stocks/abb-india",
"lastUpdated": "2026-11-16"
},
{
"slug": "adani-energy-solutions",
"name": "Adani Energy Solutions",
"ticker": "ADANIENSOL",
"sector": "Power",
"sectorSlug": "power",
"template": "standard",
"url": "https://cityfort.in/stocks/adani-energy-solutions",
"lastUpdated": "2026-11-12"
}
]
}GET /api/v1/stocks/{slug}
One company: key numbers, five years of annual results, sources.
Example request
curl https://cityfort.in/api/v1/stocks/abb-indiaExample response, from the published pages (shortened: 1 of 5 years and 2 of 20 sources shown)
{
"apiVersion": "1",
"market": "IN",
"unit": "₹ crore",
"dataAsOf": "2026-11-16",
"terms": "https://cityfort.in/api-terms",
"docs": "https://cityfort.in/developers",
"attribution": "Data: Cityfort (cityfort.in), from company filings. Link to the stock page when you use it.",
"disclaimer": "For learning only. Cityfort is not a SEBI-registered adviser and does not recommend buying or selling any security. Prices shown are dated and may be out of date.",
"data": {
"slug": "abb-india",
"name": "ABB India",
"legalName": "ABB India Limited",
"ticker": "ABB",
"sector": "Capital Goods",
"sectorSlug": "capital-goods",
"industry": "Electrical and automation equipment",
"template": "standard",
"dataDepth": "rich",
"path": "/stocks/abb-india",
"lastUpdated": "2026-11-16",
"latestQuarter": "Q3 CY26",
"fy": "CY25",
"fyEnd": "31 December (calendar year)",
"revenue": 13203,
"netProfit": 1668,
"ebitdaMarginPct": 15.5,
"netMarginPct": 12.6,
"operatingCashFlow": 1220,
"freeCashFlow": 980,
"revenueGrowthPct": 8.3,
"netProfitGrowthPct": -10.9,
"revenueCagr3yPct": 15.5,
"balanceSheetAsOf": "2026-06-30",
"netWorth": 9339,
"netDebt": -7336,
"debtToEquity": 0,
"returnOnEquityPct": 17.9,
"roeBasis": "calculated",
"promoterPct": 75,
"promoterPledgedPct": 0,
"ownershipAsOf": "Q3 CY26",
"calculated": [
"revenueGrowthPct",
"netProfitGrowthPct",
"revenueCagr3yPct",
"returnOnEquityPct"
],
"notes": [
{
"field": "returnOnEquityPct",
"text": "Cityfort calculation: CY25 net profit ÷ net worth on 30 Jun 2026."
},
{
"field": "netDebt",
"text": "Cash = cash and cash equivalents (₹1,341 crore) plus other bank balances, mostly deposits (₹5,995 crore). The company puts its own cash position at ₹7,243 crore."
},
{
"field": "netDebt",
"text": "Lease liabilities were ₹145 crore; ABB India had no borrowings in any year from CY21 to CY25."
},
{
"field": "netDebt",
"text": "Contingent liabilities were ₹571 crore on 31 Dec 2025, mostly indirect-tax claims of ₹507 crore."
},
{
"field": "netDebt",
"text": "Special dividend: ₹90 a share × 21.19 crore shares (Cityfort calculation)."
}
],
"sources": {
"annual": [
"S1"
],
"balanceSheet": [
"S6",
"S18",
"S1",
"S44"
],
"ownership": [
"S25",
"S26",
"S27",
"S28",
"S29",
"S30",
"S31",
"S32",
"S33",
"S34",
"S35",
"S36",
"S59"
]
},
"url": "https://cityfort.in/stocks/abb-india",
"annual": [
{
"fy": "CY25",
"revenue": 13203,
"ebitda": 2043,
"ebitdaMarginPct": 15.5,
"netProfit": 1668,
"netMarginPct": 12.6,
"eps": 78.73,
"operatingCashFlow": 1220,
"capex": 240,
"freeCashFlow": 980,
"src": [
"S1"
]
}
],
"sourceList": [
{
"id": "S1",
"title": "Integrated Annual Report 2025 (year ended 31 Dec 2025), incl. BRSR and standalone/consolidated statements",
"publisher": "NSE (company filing, nsearchives.nseindia.com)",
"url": "https://nsearchives.nseindia.com/annual_reports/AR_29243_ABB_2025_2025_A_14842087_09042026183132.pdf",
"publishedOn": "2026-04-09"
},
{
"id": "S2",
"title": "Annual Report 2024 (year ended 31 Dec 2024)",
"publisher": "NSE (company filing, nsearchives.nseindia.com)",
"url": "https://nsearchives.nseindia.com/annual_reports/AR_26416_ABB_2024_2024_A_09042025195714.pdf",
"publishedOn": "2025-04-09"
}
]
}
}GET /api/v1/screener
Key numbers of every company in one table (columns + rows), for filtering.
Example request
curl https://cityfort.in/api/v1/screenerExample response, from the published pages (shortened: 1 of 175 rows shown)
{
"apiVersion": "1",
"market": "IN",
"unit": "₹ crore",
"dataAsOf": "2026-11-19",
"terms": "https://cityfort.in/api-terms",
"docs": "https://cityfort.in/developers",
"attribution": "Data: Cityfort (cityfort.in), from company filings. Link to the stock page when you use it.",
"disclaimer": "For learning only. Cityfort is not a SEBI-registered adviser and does not recommend buying or selling any security. Prices shown are dated and may be out of date.",
"data": {
"columns": [
"slug",
"name",
"ticker",
"sector",
"sectorSlug",
"industry",
"template",
"dataDepth",
"url",
"lastUpdated",
"fy",
"revenue",
"netProfit",
"ebitdaMarginPct",
"netMarginPct",
"operatingCashFlow",
"freeCashFlow",
"revenueGrowthPct",
"netProfitGrowthPct",
"revenueCagr3yPct",
"balanceSheetAsOf",
"netWorth",
"netDebt",
"debtToEquity",
"returnOnEquityPct",
"roeBasis",
"promoterPct",
"promoterPledgedPct",
"ownershipAsOf",
"calculated",
"notes"
],
"rows": [
[
"abb-india",
"ABB India",
"ABB",
"Capital Goods",
"capital-goods",
"Electrical and automation equipment",
"standard",
"rich",
"https://cityfort.in/stocks/abb-india",
"2026-11-16",
"CY25",
13203,
1668,
15.5,
12.6,
1220,
980,
8.3,
-10.9,
15.5,
"2026-06-30",
9339,
-7336,
0,
17.9,
"calculated",
75,
0,
"Q3 CY26",
[
"revenueGrowthPct",
"netProfitGrowthPct",
"revenueCagr3yPct",
"returnOnEquityPct"
],
[
{
"field": "returnOnEquityPct",
"text": "Cityfort calculation: CY25 net profit ÷ net worth on 30 Jun 2026."
}
]
]
]
}
}GET /api/v1/sectors
Sectors with the number of companies in each.
Example request
curl https://cityfort.in/api/v1/sectorsExample response, from the published pages (shortened: 3 of 18 sectors shown)
{
"apiVersion": "1",
"market": "IN",
"unit": "₹ crore",
"dataAsOf": "2026-11-19",
"terms": "https://cityfort.in/api-terms",
"docs": "https://cityfort.in/developers",
"attribution": "Data: Cityfort (cityfort.in), from company filings. Link to the stock page when you use it.",
"disclaimer": "For learning only. Cityfort is not a SEBI-registered adviser and does not recommend buying or selling any security. Prices shown are dated and may be out of date.",
"data": [
{
"slug": "automobile",
"name": "Automobile and Auto Components",
"companies": 16
},
{
"slug": "capital-goods",
"name": "Capital Goods",
"companies": 21
},
{
"slug": "chemicals",
"name": "Chemicals",
"companies": 3
}
]
}Each row of annual in /api/v1/stocks/{slug} has fy, revenue, ebitda, ebitdaMarginPct, netProfit, netMarginPct, eps, operatingCashFlow, capex, freeCashFlow, periodNote, restated and src, as in the page's yearly table. sourceList gives each source's id, title, publisher, link and date. An unknown slug answers 404 with { "error": "not found" }.
What does each field mean?
The fields of one company's record, as served by /api/v1/stocks/{slug} and as the columns of /api/v1/screener. Amounts are in ₹ crore. A value the page does not support is null; nothing is estimated.
| Field | Meaning | Unit | Period |
|---|---|---|---|
slug | The company's page name on Cityfort, as in /stocks/{slug}. It never changes once published. | Text | — |
name | Short company name, as on the page. | Text | — |
legalName | Full legal name of the company. | Text | — |
ticker | NSE symbol, or the BSE code when the company is listed on BSE only. | Text | — |
sector | Sector, following NSE's sector classification. | Text | — |
sectorSlug | The sector's page name, as in /sectors/{sectorSlug}. | Text | — |
industry | The industry in a few words, as on the page. | Text | — |
template | Page type: standard or lender (banks and NBFCs). Lenders have no EBITDA margin, free cash flow or balance-sheet fields. | Text | — |
dataDepth | How much the filings cover: rich, standard or limited (fewer comparable years or quarters on file). | Text | — |
path | Path of the stock page on this site, for example /stocks/{slug}. | Text | — |
lastUpdated | Date the stock page was last updated. | Date (YYYY-MM-DD) | — |
latestQuarter | The latest quarter whose results the page covers, for example Q2 FY26. | Text | — |
fy | The latest full year on the page. Revenue, profit, margins, cash flow and growth belong to it. | Text | — |
fyEnd | When the company's financial year ends, in words. | Text | — |
revenue | Revenue from operations. For lenders, total income (interest earned plus other income). | ₹ crore | Latest full year (fy, e.g. FY25) |
netProfit | Net profit belonging to the company's owners. | ₹ crore | Latest full year (fy, e.g. FY25) |
ebitdaMarginPct | EBITDA (profit before interest, tax, depreciation and amortisation) as a share of revenue, as on the page. Null for lenders. | Percent | Latest full year (fy, e.g. FY25) |
netMarginPct | Net profit as a share of revenue, as on the page. | Percent | Latest full year (fy, e.g. FY25) |
operatingCashFlow | Cash from operating activities, from the cash flow statement. | ₹ crore | Latest full year (fy, e.g. FY25) |
freeCashFlow | Operating cash flow minus capital spending, as on the page. Null for lenders. | ₹ crore | Latest full year (fy, e.g. FY25) |
revenueGrowthPct | Cityfort calculation. Revenue change from the year before to the latest year. Null when a year is missing or not comparable (a short year, a demerger). | Percent | Latest full year (fy, e.g. FY25) |
netProfitGrowthPct | Cityfort calculation. Net profit change from the year before to the latest year. Null when the earlier year's profit is zero or negative, or the years are not comparable. | Percent | Latest full year (fy, e.g. FY25) |
revenueCagr3yPct | Cityfort calculation. Compound yearly revenue growth over the three years to the latest year. Null with fewer than four comparable years. | Percent a year | Three years to fy |
balanceSheetAsOf | Date of the balance sheet that netWorth, netDebt and debtToEquity come from. Null when the page has no balance-sheet section. | Date (YYYY-MM-DD) | — |
netWorth | Net worth (shareholders' money in the company). | ₹ crore | Balance-sheet date (balanceSheetAsOf) |
netDebt | Total debt minus cash and investments, as on the page. Negative means more cash than debt. | ₹ crore | Balance-sheet date (balanceSheetAsOf) |
debtToEquity | Total debt divided by net worth, as on the page. Null when net worth is zero or negative. | Times (ratio) | Balance-sheet date (balanceSheetAsOf) |
returnOnEquityPct | Return on equity. When roeBasis is reported, the lender's own figure; when calculated, a Cityfort calculation: net profit for fy divided by net worth on balanceSheetAsOf. | Percent | Latest full year (fy, e.g. FY25) |
roeBasis | reported (the company's own return on equity), calculated (a Cityfort calculation) or null. | Text | — |
promoterPct | Shares held by the promoter group (the founding family or parent company that controls it), as a share of all shares. | Percent | ownershipAsOf |
promoterPledgedPct | Promoter shares given as loan collateral (pledged), as a share of the promoter group's own shares. | Percent | ownershipAsOf |
ownershipAsOf | The quarter the shareholding figures are from. | Text | — |
calculated | The fields of this record that are Cityfort calculations, not numbers printed on the page. | List of field names | — |
notes | Why a number may not compare like-for-like with another company's (a short year, a demerger, a restated year, how debt is counted). Each note names a field, or row for the whole record. | List of { field, text } | — |
sources | Source ids on the stock page behind the annual, balance-sheet and ownership numbers. /api/v1/stocks/{slug} lists each source's title, publisher, link and date in sourceList. | Lists of ids (S1, S2 …) | — |
url | Full address of the stock page. Link to it wherever you show the data (see the attribution below). | Text | — |
What are the rate limits?
10 requests per 10 seconds and 30 requests per minute per IP address; more answers 429 with Retry-After. Repeated abuse is blocked.
- 429 Too Many Requests: wait the number of seconds in the
Retry-Afterheader (alsoretryAfterSecondsin the body), then try again. A client that keeps sending after a 429 waits 10 minutes. - 403 Forbidden: the client (an IP address, network or user agent) is blocked for breaking the rate limits or the data terms. The body says until when. Automatic blocks last 24 hours, then 7 days, then 30 days for repeat offences.
- Need many companies? Call
/api/v1/screeneronce: it has every company's record in one table. Please don't call/api/v1/stocks/{slug}for every company. - Data changes only when a page is updated, so keep a copy and check
dataAsOf. Browsers may keep a response for 5 minutes.
Is there an MCP server?
Yes: https://cityfort.in/mcp is a read-only remote MCP (Model Context Protocol) server over the same data, for assistants and tools that speak MCP. It uses the Streamable HTTP transport with plain JSON answers, needs no sign-up or key, and counts against the same rate limits as the API.
search_companies: Find companies that have a Cityfort stock page by name, ticker or sector. Returns each match's slug (for get_company), name, ticker, sector, page URL and last update. Exact name, ticker or slug matches first, then A–Z.get_company: One company's key numbers from its Cityfort stock page: revenue, profit, margins, cash flow, debt and ownership for the latest year, up to five years of annual results, and the page's source documents (id, title, publisher, link, date). Amounts in ₹ crore. Facts from filings only: no prices, ratings or advice.screen_companies: Filter every Cityfort company by its latest-year numbers. Results are A–Z by name unless sort_by is given; this is a filter, not a ranking or a recommendation. A company without a value for an active filter (for example debt to equity for a bank) is left out and counted in leftOut. Amounts in ₹ crore; percentages as numbers (12.5 = 12.5%).compare_companies: The key numbers of two Cityfort companies side by side, each for its own latest year and with its own sources. Facts only, no verdict.
Every tool result carries the attribution, the notice in disclaimer and the stock page links. Add it to a client that reads an mcpServers list like this:
{
"mcpServers": {
"cityfort": {
"type": "http",
"url": "https://cityfort.in/mcp"
}
}
}Or try it with curl (one JSON-RPC 2.0 request per POST; a GET answers 405):
curl -s -X POST https://cityfort.in/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Protocol versions: 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26 (the first is the current revision, without a handshake; the others start with initialize). No sessions and no server-sent events.
How do I credit Cityfort?
Wherever you show the numbers, write “Data: Cityfort” with a normal, followed link (no rel="nofollow") to the company's stock page, from the record's url:
<p>Data: <a href="https://cityfort.in/stocks/abb-india">Cityfort</a></p>Show each number with its period (for example FY25) and the page's update date, and keep the numbers as the API gives them. Never present them as a recommendation, rating or ranking. The full rules are in the Cityfort data terms.
Prefer a ready-made card? Each stock page has embed codes for a key-numbers card and the ₹100 receipt, each with a link back to the page.
Will the API change?
Within v1, a field is never removed or renamed and never changes meaning. New fields may be added, so ignore fields you don't know. A change that breaks this would come only as a new version (/api/v2/), announced on this page.
Changelog
- v1 (15 Nov 2026): first version. Endpoints
/api/v1,/api/v1/stocks,/api/v1/stocks/{slug},/api/v1/screenerand/api/v1/sectors.