Skip to main content
All providers

SEC EDGAR

FinanceUS

data.sec.gov

US company filings and XBRL facts: every submission, every reported financial concept, by CIK.

Capabilities (8)

GET /v1/data/sec/companyconcept1 credit

Returns the full reported history of a single us-gaap line item for one company (every value, period, form and accession) instead of the whole facts blob.

cikconcept
GET /v1/data/sec/companyfacts1 credit

Returns every XBRL fact the company has ever reported, grouped by taxonomy (us-gaap, dei, ifrs-full) then by tag then by unit, each value carrying its period, fiscal year/quarter, form and accession number.

cik
GET /v1/data/sec/company-tickers1 credit

Returns the SEC's master list of exchange-listed companies as an object of {cik_str, ticker, title} records, about 10,000 rows.

No parameters
GET /v1/data/sec/company-tickers-exchange1 credit

Returns the same ticker-to-CIK mapping in a compact columnar form (fields [cik, name, ticker, exchange] and an array of rows), adding the listing venue (Nasdaq, NYSE, CBOE, OTC).

No parameters
GET /v1/data/sec/filing-index1 credit

Returns the EDGAR archive directory listing for a single filing: every document in it with name, type and last-modified time, so you can locate the exhibits, the XBRL instance or the primary HTML.

cikaccession
GET /v1/data/sec/frames1 credit

Returns one us-gaap concept in USD for every company that reported it in a given period: a cross-sectional frame of CIK, entity name, value and accession, suitable for ranking or screening.

conceptperiod
GET /v1/data/sec/mutual-fund-tickers1 credit

Returns the mapping of registered fund tickers to their CIK, series id (S000…) and class id (C000…) in columnar [cik, seriesId, classId, symbol] form.

No parameters
GET /v1/data/sec/submissions1 credit

Returns an issuer's EDGAR profile (name, tickers, exchanges, SIC, EIN, addresses, former names) plus the most recent ~1000 filings as parallel arrays of accession number, form type, filing date and primary document.

cik

Response example

The shape of data from sec/companyconcept (One XBRL concept for a company). A sample, not live data.

JSON
{
  "cik": 320193,
  "taxonomy": "us-gaap",
  "tag": "RevenueFromContractWithCustomerExcludingAssessedTax",
  "label": "Revenue from Contract with Customer, Excluding Assessed Tax",
  "description": "Amount, excluding tax collected from customer, of revenue from satisfaction of performance obligation by transferring promised good or service to customer. Tax collected from customer is tax assessed by governmental authority that is both imposed on and concurrent with specific revenue-producing tra…",
  "entityName": "Apple Inc.",
  "units": {
    "USD": [
      {
        "start": "2016-09-25",
        "end": "2017-09-30",
        "val": 229234000000,
        "accn": "0000320193-19-000119",
        "fy": 2019,
        "fp": "FY",
        "form": "10-K",
        "filed": "2019-10-31",
        "frame": "CY2017"
      },
      {
        "start": "2017-10-01",
        "end": "2017-12-30",
        "val": 88293000000,
        "accn": "0000320193-19-000010",
        "fy": 2019,
        "fp": "Q1",
        "form": "10-Q",
        "filed": "2019-01-30"
      },
      "… 115 more items"
    ]
  }
}

Ask with this source

A prompt for your agent that names this source and how to call it through the crw MCP.

  • One XBRL concept for a company

    Use SEC EDGAR (sec) from fastCRW Pergamon, capability "One XBRL concept for a company" (companyconcept). You want one specific financial metric over time for one company and do not want to download several megabytes of facts. Example options: cik=0000320193, concept=RevenueFromContractWithCustomerExcludingAssessedTax. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "sec" and capability "companyconcept". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>

  • All XBRL facts for a company

    Use SEC EDGAR (sec) from fastCRW Pergamon, capability "All XBRL facts for a company" (companyfacts). You want a company's whole reported financial history in one call and will pick the line items yourself. Example options: cik=0000320193. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "sec" and capability "companyfacts". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>

  • Ticker to CIK map

    Use SEC EDGAR (sec) from fastCRW Pergamon, capability "Ticker to CIK map" (company-tickers). You hold a ticker or a company name and need the CIK that every other SEC capability requires. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "sec" and capability "company-tickers". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>

  • Ticker to CIK map with exchange

    Use SEC EDGAR (sec) from fastCRW Pergamon, capability "Ticker to CIK map with exchange" (company-tickers-exchange). You need ticker-to-CIK resolution and also care which exchange the security trades on. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "sec" and capability "company-tickers-exchange". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>

Licence

A work of the United States Government, not subject to domestic copyright under 17 U.S.C. 105, published by the agency as open data.

https://www.sec.gov/about/privacy-information#security

Attribution

Display this wherever you show the data. It arrives on every response as provenance.attribution_text.

Source: U.S. Securities and Exchange Commission, EDGAR

Cache: up to 3600s