Skip to content
New: 100+ more US companies, including the big banks, plus insider trades from SEC filings

For developers

Cityfort data API for developers

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

Last updated Nov 20, 2026 · Data as of Nov 20, 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 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/v1

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

Example 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/3m

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

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

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

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—
tickerStock ticker on its US exchange (Nasdaq, NYSE or NYSE American).Text—
sectorOne of 11 broad sectors (for example Technology or Health Care).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, lender (banks), insurer or reit. Banks, insurers and REITs have no EBITDA margin or balance-sheet fields.Text—
dataDepthHow much the filings cover: rich (a lot), standard (some) or limited (little: fewer than five comparable years of annual results).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 Q3 FY2025.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. For banks, total net revenue (net interest income plus noninterest income).US$ millionLatest fiscal year (fy, e.g. FY2025)
netProfitNet income attributable to the company's common stockholders.US$ millionLatest fiscal year (fy, e.g. FY2025)
ebitdaMarginPctEBITDA (operating income plus depreciation and amortization) as a share of revenue, as on the page. Null for banks, insurers and REITs.PercentLatest fiscal year (fy, e.g. FY2025)
netMarginPctNet profit as a share of revenue, as on the page.PercentLatest fiscal year (fy, e.g. FY2025)
operatingCashFlowCash from operating activities, from the cash flow statement.US$ millionLatest fiscal year (fy, e.g. FY2025)
freeCashFlowOperating cash flow minus capital spending, as on the page. Null for banks and insurers.US$ millionLatest fiscal year (fy, e.g. FY2025)
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 fiscal year (fy, e.g. FY2025)
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 fiscal year (fy, e.g. FY2025)
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)—
netWorthShareholders' equity.US$ millionBalance-sheet date (balanceSheetAsOf)
netDebtTotal debt minus cash and investments, as on the page. Negative means more cash than debt.US$ millionBalance-sheet date (balanceSheetAsOf)
debtToEquityTotal debt divided by stockholders' equity, as on the page. Null when equity is zero or negative.Times (ratio)Balance-sheet date (balanceSheetAsOf)
returnOnEquityPctReturn 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.PercentLatest fiscal year (fy, e.g. FY2025)
roeBasisreported (the company's own return on equity), calculated (a Cityfort calculation) or null.Text—
insidersPctShares held by directors and executive officers as a group, as a share of all shares (proxy statement).PercentownershipAsOf
insidersVotingPctVotes held by directors and executive officers as a group, as a share of all votes.PercentownershipAsOf
multipleShareClassesTrue when the company has more than one class of shares with different votes per share.true or false—
ownershipAsOfThe record date of the ownership figures.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 offenses.
  • 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.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/screener and /api/v1/sectors.