scrollport
Back to U.S. SEC EDGAR API

Company Facts

U.S. SEC

Retrieve U.S.

Capability
U.S. SEC EDGAR API
Current price
$0.0050/call
Availability
Ready to run
Last accepted verification

What this API does

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.

Agents select this operation with tool ID sec.company-facts, then inspect its current executable contract before a run.

Public input and output shape

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

This reviewed worked example is shared with inspect. Inspect also returns the current executable schema and price estimate before a paid run.

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

Use Company Facts with Scrollport

Use Scrollport

Scrollport identifies and validates the best-in-class API tools and provides them on a pay-as-you-go basis so you don't need to maintain a separate provider account, subscription or credits.

Give your agent the setup prompt to receive $1 in trial credit and start using the tools right away.