Company Facts

Retrieve U.S. SEC XBRL revenue, net income, assets, liabilities, equity, cash, operating cash flow and diluted EPS by CIK.

by U.S. SECReady to run$0.0050 per request · $0.50 per 100 requests

Example

You ask your agent

“Get Apple's reported revenue for the last four periods from its SEC filings.”

You get

CIK: 0000320193
Metrics: Revenue from Contract with Customer, Excluding Assessed Tax
Source URL: https://www.sec.gov/edgar/browse/?CIK=0000320193&owner=exclude
Entity name: Apple Inc.

What your agent sends and gets back (JSON)

Your agent works out the exact inputs, such as IDs, dates and settings, from what you ask.

Request

{
  "tool_id": "sec.company-facts",
  "input": {
    "cik": "0000320193",
    "periods": 4
  }
}

Response

{
  "cik": "0000320193",
  "metrics": [
    {
      "unit": "USD",
      "label": "Revenue from Contract with Customer, Excluding Assessed Tax",
      "metric": "revenue",
      "concept": "RevenueFromContractWithCustomerExcludingAssessedTax",
      "periods": [
        {
          "end": "2024-09-28",
          "form": "10-K",
          "filed": "2024-11-01",
          "start": "2023-10-01",
          "value": "391035000000",
          "source_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/0000320193-24-000123-index.html",
          "fiscal_year": 2024,
          "fiscal_period": "FY",
          "accession_number": "0000320193-24-000123"
        }
      ],
      "taxonomy": "us-gaap"
    }
  ],
  "source_url": "https://www.sec.gov/edgar/browse/?CIK=0000320193&owner=exclude",
  "captured_at": "2026-08-20T00:00:00.000Z",
  "entity_name": "Apple Inc.",
  "missing_metrics": []
}

Use it with your agent

Copy the prompt and paste it into your agent, then tell it what you need.

Read https://scrollport.com/start. Use my existing Scrollport connection, or help me connect if needed. Help me use Company Facts (tool ID: sec.company-facts). Ask me for the details you need, then show me the result.

Provider access is included. If your agent isn't connected to Scrollport yet, it will help you set that up.

Other tools for this job

Compare all 3 →

Company LookupU.S. SEC$0.0050 per request$0.0050 per request
FilingsU.S. SEC$0.0050 per request$0.0050 per request

Questions

Is Company Facts by U.S. SEC free?

Scrollport has no free tier: it costs $0.0050 per request ($0.50 per 100 requests), paid per use from a prepaid wallet with no subscription. Connecting your first agent adds $1 of trial credit, so you can try it before adding funds.

Do I need an API key from U.S. SEC?

No. Your agent runs it through your Scrollport connection (MCP, the Scrollport CLI or the HTTP API), and Scrollport handles access to U.S. SEC, so you don't sign up with U.S. SEC or manage an API key.

Details

About this tool

Normalize up to eight common US-GAAP metrics for one exact CIK: revenue, net income, assets, liabilities, stockholders' equity, cash and equivalents, operating cash flow and diluted EPS. Callers may select metrics, base forms and one to eight periods. Priority-ordered concept aliases handle common filer variation; the latest-filed context wins for each fiscal period, values remain decimal strings, units and accession provenance remain explicit, and missing metrics are reported rather than invented.

All inputs and outputs

Input

cikstring · required

SEC Central Index Key, with or without leading zeroes; output is always ten digits.

formsarray · optional

minItems: 1 · maxItems: 5

include_amendmentsboolean · optional

metricsarray · optional

minItems: 1 · maxItems: 8

periodsinteger · optional

minimum: 1 · maximum: 8

Output

captured_atstring

When the data was retrieved.

cikstring

entity_namestring

metricsarray

missing_metricsarray

source_urlstring

URL of the source the record came from.

Errors and limits

invalid_input: CIK, metric, form or period selection was outside the bounded SEC company-facts contract.example: {"cik":"0000320193","periods":4}