Back to Search SEC filings

Company Facts

U.S. SEC

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

Use this tool with your AI agent

  1. Copy the prompt
  2. Paste it into your agent
  3. 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.

Already connected
Your agent can use that connection.
New user
Your agent will guide you through setup, sign-in and authorisation.

Provider access is included.

Connect your first agent to receive $1 trial credit.

Current price
$0.0050/request
Availability
Ready to run

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

Inputs and outputs

Input

cikstring · required

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

formsarray · optional

Value supplied for forms.

minItems: 1 · maxItems: 5

include_amendmentsboolean · optional

Value supplied for include amendments.

metricsarray · optional

Value supplied for metrics.

minItems: 1 · maxItems: 8

periodsinteger · optional

Value supplied for periods.

minimum: 1 · maximum: 8

Output

captured_atstring

Returned captured at value.

cikstring

Returned cik value.

entity_namestring

Returned entity name value.

metricsarray

Returned metrics value.

missing_metricsarray

Returned missing metrics value.

source_urlstring

Returned source url value.

Example request and output

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

Request

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

Output

{
  "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": []
}
Errors and limitations
  • invalid_input: CIK, metric, form or period selection was outside the bounded SEC company-facts contract.example: {"cik":"0000320193","periods":4}