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

**Job:** [Search SEC filings](https://scrollport.com/tools/sec-edgar-api)

**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

`cik` string · required

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

`forms` array · optional

Value supplied for forms.

minItems: 1 · maxItems: 5

`include_amendments` boolean · optional

Value supplied for include amendments.

`metrics` array · optional

Value supplied for metrics.

minItems: 1 · maxItems: 8

`periods` integer · optional

Value supplied for periods.

minimum: 1 · maximum: 8

### Output

`captured_at` string

Returned captured at value.

`cik` string

Returned cik value.

`entity_name` string

Returned entity name value.

`metrics` array

Returned metrics value.

`missing_metrics` array

Returned missing metrics value.

`source_url` string

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}

---

Canonical page: https://scrollport.com/tools/providers/sec/company-facts