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 301 companies with pages on this site. Amounts are in US$ million.
- No share prices, market values or price-based ratios, and no non-GAAP (adjusted) measures.
- 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.co/api/v1Example response, from the published pages
{
"apiVersion": "1",
"market": "US",
"unit": "US$ million",
"dataAsOf": "2026-11-20",
"terms": "https://cityfort.co/api-terms",
"docs": "https://cityfort.co/developers",
"attribution": "Data: Cityfort (cityfort.co), from company filings. Link to the stock page when you use it.",
"disclaimer": "For learning only. Cityfort is not a registered investment adviser or broker-dealer 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.co/api/v1"
},
{
"path": "/api/v1/stocks",
"about": "Every company on this site: name, ticker, sector, page link, last update.",
"url": "https://cityfort.co/api/v1/stocks"
},
{
"path": "/api/v1/stocks/{slug}",
"about": "One company: key numbers, five years of annual results, sources.",
"url": "https://cityfort.co/api/v1/stocks/{slug}"
},
{
"path": "/api/v1/screener",
"about": "Key numbers of every company in one table (columns + rows), for filtering.",
"url": "https://cityfort.co/api/v1/screener"
},
{
"path": "/api/v1/sectors",
"about": "Sectors with the number of companies in each.",
"url": "https://cityfort.co/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": 301
}
}GET /api/v1/stocks
Every company on this site: name, ticker, sector, page link, last update.
Example request
curl https://cityfort.co/api/v1/stocksExample response, from the published pages (shortened: 2 of 301 companies shown)
{
"apiVersion": "1",
"market": "US",
"unit": "US$ million",
"dataAsOf": "2026-11-20",
"terms": "https://cityfort.co/api-terms",
"docs": "https://cityfort.co/developers",
"attribution": "Data: Cityfort (cityfort.co), from company filings. Link to the stock page when you use it.",
"disclaimer": "For learning only. Cityfort is not a registered investment adviser or broker-dealer and does not recommend buying or selling any security. Prices shown are dated and may be out of date.",
"data": [
{
"slug": "3m",
"name": "3M",
"ticker": "MMM",
"sector": "Industrials",
"sectorSlug": "industrials",
"template": "standard",
"url": "https://cityfort.co/stocks/3m",
"lastUpdated": "2026-11-06"
},
{
"slug": "abbott",
"name": "Abbott",
"ticker": "ABT",
"sector": "Health Care",
"sectorSlug": "health-care",
"template": "standard",
"url": "https://cityfort.co/stocks/abbott",
"lastUpdated": "2026-11-06"
}
]
}GET /api/v1/stocks/{slug}
One company: key numbers, five years of annual results, sources.
Example request
curl https://cityfort.co/api/v1/stocks/3mExample response, from the published pages (shortened: 1 of 5 years and 2 of 8 sources shown)
{
"apiVersion": "1",
"market": "US",
"unit": "US$ million",
"dataAsOf": "2026-11-06",
"terms": "https://cityfort.co/api-terms",
"docs": "https://cityfort.co/developers",
"attribution": "Data: Cityfort (cityfort.co), from company filings. Link to the stock page when you use it.",
"disclaimer": "For learning only. Cityfort is not a registered investment adviser or broker-dealer and does not recommend buying or selling any security. Prices shown are dated and may be out of date.",
"data": {
"slug": "3m",
"name": "3M",
"legalName": "3M Company",
"ticker": "MMM",
"sector": "Industrials",
"sectorSlug": "industrials",
"industry": "Tapes, adhesives, abrasives, safety equipment, electronics materials and consumer products",
"template": "standard",
"dataDepth": "standard",
"path": "/stocks/3m",
"lastUpdated": "2026-11-06",
"latestQuarter": "Q3 FY2026",
"fy": "FY2025",
"fyEnd": "Fiscal year ends Dec 31",
"revenue": 24948,
"netProfit": 3250,
"ebitdaMarginPct": 23.8,
"netMarginPct": 13,
"operatingCashFlow": 2306,
"freeCashFlow": 1396,
"revenueGrowthPct": 1.5,
"netProfitGrowthPct": -18.9,
"revenueCagr3yPct": -1.6,
"balanceSheetAsOf": "2026-09-30",
"netWorth": 4127,
"netDebt": 9852,
"debtToEquity": 3.6,
"returnOnEquityPct": 78.7,
"roeBasis": "calculated",
"insidersPct": 0.11,
"insidersVotingPct": null,
"multipleShareClasses": false,
"ownershipAsOf": "2026-02-27",
"calculated": [
"revenueGrowthPct",
"netProfitGrowthPct",
"revenueCagr3yPct",
"returnOnEquityPct"
],
"notes": [
{
"field": "returnOnEquityPct",
"text": "Cityfort calculation: FY2025 net income ÷ stockholders' equity on Sep 30, 2026."
},
{
"field": "netDebt",
"text": "Net debt of $9,852 million is total debt minus cash ($4,835 million) and current marketable securities ($310 million) (Cityfort calculation from the Q3 FY2026 10-Q). Total debt was $12,602 million on Dec 31, 2025."
},
{
"field": "netDebt",
"text": "Debt rose in 2026 after 3M issued €1.5 billion of notes in September and its venture subsidiary drew a $1.43 billion 364-day term loan in July to buy Madison Fire & Rescue, with 3M as guarantor; $650 million of notes were repaid in September."
},
{
"field": "netDebt",
"text": "Litigation liabilities are shown apart from debt: $7.5 billion for PFAS environmental matters ($2.8 billion due within a year) and $1.1 billion for the Combat Arms Earplugs settlement on Sep 30, 2026. The Nov 3, 2026 firefighting-foam settlement adds $7.35 billion in nominal payments from 2026 to 2034."
},
{
"field": "netDebt",
"text": "Debt to equity of 3.6 uses total 3M shareholders' equity of $4,127 million, which is low after the FY2023 settlement charges. Bain's interest in the Madison venture, $971 million, sits outside equity as a redeemable noncontrolling interest."
},
{
"field": "netDebt",
"text": "3M's remaining Solventum stake was valued at $2,254 million on Sep 30, 2026 and is not counted as cash here."
},
{
"field": "netDebt",
"text": "Interest cover is left blank: FY2025 interest expense of $946 million includes imputed interest on settlement obligations, and interest on debt was $448 million."
},
{
"field": "netDebt",
"text": "3M signed a $4.25 billion revolving credit agreement on Aug 17, 2026."
}
],
"sources": {
"annual": [
"S1"
],
"balanceSheet": [
"S5",
"S1",
"S19",
"S21"
],
"ownership": [
"S18",
"S5"
]
},
"url": "https://cityfort.co/stocks/3m",
"annual": [
{
"fy": "FY2025",
"revenue": 24948,
"ebitda": 5937,
"ebitdaMarginPct": 23.8,
"netProfit": 3250,
"netMarginPct": 13,
"eps": 6,
"operatingCashFlow": 2306,
"capex": 910,
"freeCashFlow": 1396,
"src": [
"S1"
]
}
],
"sourceList": [
{
"id": "S1",
"title": "Form 10-K, fiscal year 2025 (ended Dec 31, 2025)",
"publisher": "3M Company (SEC EDGAR)",
"url": "https://www.sec.gov/Archives/edgar/data/66740/000006674026000014/mmm-20251231.htm",
"publishedOn": "2026-02-03"
},
{
"id": "S2",
"title": "Form 10-K, fiscal year 2024 (ended Dec 31, 2024)",
"publisher": "3M Company (SEC EDGAR)",
"url": "https://www.sec.gov/Archives/edgar/data/66740/000006674025000006/mmm-20241231.htm",
"publishedOn": "2025-02-05"
}
]
}
}GET /api/v1/screener
Key numbers of every company in one table (columns + rows), for filtering.
Example request
curl https://cityfort.co/api/v1/screenerExample response, from the published pages (shortened: 1 of 301 rows shown)
{
"apiVersion": "1",
"market": "US",
"unit": "US$ million",
"dataAsOf": "2026-11-20",
"terms": "https://cityfort.co/api-terms",
"docs": "https://cityfort.co/developers",
"attribution": "Data: Cityfort (cityfort.co), from company filings. Link to the stock page when you use it.",
"disclaimer": "For learning only. Cityfort is not a registered investment adviser or broker-dealer 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",
"insidersPct",
"insidersVotingPct",
"multipleShareClasses",
"ownershipAsOf",
"calculated",
"notes"
],
"rows": [
[
"3m",
"3M",
"MMM",
"Industrials",
"industrials",
"Tapes, adhesives, abrasives, safety equipment, electronics materials and consumer products",
"standard",
"standard",
"https://cityfort.co/stocks/3m",
"2026-11-06",
"FY2025",
24948,
3250,
23.8,
13,
2306,
1396,
1.5,
-18.9,
-1.6,
"2026-09-30",
4127,
9852,
3.6,
78.7,
"calculated",
0.11,
null,
false,
"2026-02-27",
[
"revenueGrowthPct",
"netProfitGrowthPct",
"revenueCagr3yPct",
"returnOnEquityPct"
],
[
{
"field": "returnOnEquityPct",
"text": "Cityfort calculation: FY2025 net income ÷ stockholders' equity on Sep 30, 2026."
},
{
"field": "netDebt",
"text": "3M's remaining Solventum stake was valued at $2,254 million on Sep 30, 2026 and is not counted as cash here."
}
]
]
]
}
}GET /api/v1/sectors
Sectors with the number of companies in each.
Example request
curl https://cityfort.co/api/v1/sectorsExample response, from the published pages (shortened: 3 of 11 sectors shown)
{
"apiVersion": "1",
"market": "US",
"unit": "US$ million",
"dataAsOf": "2026-11-20",
"terms": "https://cityfort.co/api-terms",
"docs": "https://cityfort.co/developers",
"attribution": "Data: Cityfort (cityfort.co), from company filings. Link to the stock page when you use it.",
"disclaimer": "For learning only. Cityfort is not a registered investment adviser or broker-dealer and does not recommend buying or selling any security. Prices shown are dated and may be out of date.",
"data": [
{
"slug": "communication-services",
"name": "Communication Services",
"companies": 16
},
{
"slug": "consumer-discretionary",
"name": "Consumer Discretionary",
"companies": 39
},
{
"slug": "consumer-staples",
"name": "Consumer Staples",
"companies": 20
}
]
}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 US$ million. 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 | Stock ticker on its US exchange (Nasdaq, NYSE or NYSE American). | Text | — |
sector | One of 11 broad sectors (for example Technology or Health Care). | 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, lender (banks), insurer or reit. Banks, insurers and REITs have no EBITDA margin or balance-sheet fields. | Text | — |
dataDepth | How much the filings cover: rich (a lot), standard (some) or limited (little: fewer than five comparable years of annual results). | 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 Q3 FY2025. | 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. For banks, total net revenue (net interest income plus noninterest income). | US$ million | Latest fiscal year (fy, e.g. FY2025) |
netProfit | Net income attributable to the company's common stockholders. | US$ million | Latest fiscal year (fy, e.g. FY2025) |
ebitdaMarginPct | EBITDA (operating income plus depreciation and amortization) as a share of revenue, as on the page. Null for banks, insurers and REITs. | Percent | Latest fiscal year (fy, e.g. FY2025) |
netMarginPct | Net profit as a share of revenue, as on the page. | Percent | Latest fiscal year (fy, e.g. FY2025) |
operatingCashFlow | Cash from operating activities, from the cash flow statement. | US$ million | Latest fiscal year (fy, e.g. FY2025) |
freeCashFlow | Operating cash flow minus capital spending, as on the page. Null for banks and insurers. | US$ million | Latest fiscal year (fy, e.g. FY2025) |
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 fiscal year (fy, e.g. FY2025) |
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 fiscal year (fy, e.g. FY2025) |
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 | Shareholders' equity. | US$ million | Balance-sheet date (balanceSheetAsOf) |
netDebt | Total debt minus cash and investments, as on the page. Negative means more cash than debt. | US$ million | Balance-sheet date (balanceSheetAsOf) |
debtToEquity | Total debt divided by stockholders' equity, as on the page. Null when equity is zero or negative. | Times (ratio) | Balance-sheet date (balanceSheetAsOf) |
returnOnEquityPct | Return on equity. When roeBasis is reported, the company's own figure (banks, insurers); when calculated, a Cityfort calculation: net income for fy divided by equity on balanceSheetAsOf. | Percent | Latest fiscal year (fy, e.g. FY2025) |
roeBasis | reported (the company's own return on equity), calculated (a Cityfort calculation) or null. | Text | — |
insidersPct | Shares held by directors and executive officers as a group, as a share of all shares (proxy statement). | Percent | ownershipAsOf |
insidersVotingPct | Votes held by directors and executive officers as a group, as a share of all votes. | Percent | ownershipAsOf |
multipleShareClasses | True when the company has more than one class of shares with different votes per share. | true or false | — |
ownershipAsOf | The record date of the ownership figures. | 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 offenses.
- 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.co/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 US$ million. 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 US$ million; 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.co/mcp"
}
}
}Or try it with curl (one JSON-RPC 2.0 request per POST; a GET answers 405):
curl -s -X POST https://cityfort.co/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.co/stocks/3m">Cityfort</a></p>Show each number with its period (for example FY2025) 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 (Nov 15, 2026): first version. Endpoints
/api/v1,/api/v1/stocks,/api/v1/stocks/{slug},/api/v1/screenerand/api/v1/sectors.