Skip to content
New: 30 more Indian companies explained, from Ather and Pine Labs to IDBI Bank

For developers

Cityfort data API for developers

The key numbers from every company page on Cityfort, as JSON: revenue, net profit, margins, cash flow, debt and ownership, each with its period and source.

Last updated 19 Nov 2026 · Data as of 19 Nov 2026 (the newest page update) · API version 1

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 calculated are 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/v1

Example 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/stocks

Example 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-india

Example 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/screener

Example 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/sectors

Example 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.

Fields of a company record in the Cityfort data API
FieldMeaningUnitPeriod
slugThe company's page name on Cityfort, as in /stocks/{slug}. It never changes once published.Text—
nameShort company name, as on the page.Text—
legalNameFull legal name of the company.Text—
tickerNSE symbol, or the BSE code when the company is listed on BSE only.Text—
sectorSector, following NSE's sector classification.Text—
sectorSlugThe sector's page name, as in /sectors/{sectorSlug}.Text—
industryThe industry in a few words, as on the page.Text—
templatePage type: standard or lender (banks and NBFCs). Lenders have no EBITDA margin, free cash flow or balance-sheet fields.Text—
dataDepthHow much the filings cover: rich, standard or limited (fewer comparable years or quarters on file).Text—
pathPath of the stock page on this site, for example /stocks/{slug}.Text—
lastUpdatedDate the stock page was last updated.Date (YYYY-MM-DD)—
latestQuarterThe latest quarter whose results the page covers, for example Q2 FY26.Text—
fyThe latest full year on the page. Revenue, profit, margins, cash flow and growth belong to it.Text—
fyEndWhen the company's financial year ends, in words.Text—
revenueRevenue from operations. For lenders, total income (interest earned plus other income).₹ croreLatest full year (fy, e.g. FY25)
netProfitNet profit belonging to the company's owners.₹ croreLatest full year (fy, e.g. FY25)
ebitdaMarginPctEBITDA (profit before interest, tax, depreciation and amortisation) as a share of revenue, as on the page. Null for lenders.PercentLatest full year (fy, e.g. FY25)
netMarginPctNet profit as a share of revenue, as on the page.PercentLatest full year (fy, e.g. FY25)
operatingCashFlowCash from operating activities, from the cash flow statement.₹ croreLatest full year (fy, e.g. FY25)
freeCashFlowOperating cash flow minus capital spending, as on the page. Null for lenders.₹ croreLatest full year (fy, e.g. FY25)
revenueGrowthPctCityfort 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).PercentLatest full year (fy, e.g. FY25)
netProfitGrowthPctCityfort 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.PercentLatest full year (fy, e.g. FY25)
revenueCagr3yPctCityfort calculation. Compound yearly revenue growth over the three years to the latest year. Null with fewer than four comparable years.Percent a yearThree years to fy
balanceSheetAsOfDate of the balance sheet that netWorth, netDebt and debtToEquity come from. Null when the page has no balance-sheet section.Date (YYYY-MM-DD)—
netWorthNet worth (shareholders' money in the company).₹ croreBalance-sheet date (balanceSheetAsOf)
netDebtTotal debt minus cash and investments, as on the page. Negative means more cash than debt.₹ croreBalance-sheet date (balanceSheetAsOf)
debtToEquityTotal debt divided by net worth, as on the page. Null when net worth is zero or negative.Times (ratio)Balance-sheet date (balanceSheetAsOf)
returnOnEquityPctReturn 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.PercentLatest full year (fy, e.g. FY25)
roeBasisreported (the company's own return on equity), calculated (a Cityfort calculation) or null.Text—
promoterPctShares held by the promoter group (the founding family or parent company that controls it), as a share of all shares.PercentownershipAsOf
promoterPledgedPctPromoter shares given as loan collateral (pledged), as a share of the promoter group's own shares.PercentownershipAsOf
ownershipAsOfThe quarter the shareholding figures are from.Text—
calculatedThe fields of this record that are Cityfort calculations, not numbers printed on the page.List of field names—
notesWhy 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 }—
sourcesSource 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 …)—
urlFull 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-After header (also retryAfterSeconds in 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/screener once: 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/screener and /api/v1/sectors.