SEC EDGAR: Get Company Concept

Get one reported financial figure, such as revenue or net income, for a public company over time from its SEC filings.

Tool ID: sec_edgar_get_company_concept

Run this action

Use the TypeScript SDK for one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'sec_edgar_get_company_concept',
  {
    "tag": "example"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute sec_edgar_get_company_concept --input '{
  "tag": "example"
}' --json

Example response

The SDK returns this shape at result.toolResponse.raw. The example values illustrate the response.

{
  "company": {
    "cik": "example",
    "name": "Example",
    "tickers": [
      "example"
    ],
    "exchanges": [
      "example"
    ]
  },
  "taxonomy": "example",
  "tag": "example",
  "units": [
    {
      "unit": "example",
      "facts": [
        {
          "value": {},
          "end": "example",
          "form": "example",
          "filed_at": "2026-01-15T12:00:00Z",
          "accession_number": "example",
          "filing_url": "https://example.com/resource"
        }
      ],
      "total_fact_count": 123,
      "is_partial": true
    }
  ],
  "source_url": "https://example.com/resource"
}

Use deepline describe sec_edgar_get_company_concept --json for the latest machine-readable contract.

Input reference

Name	Type	Required	Default	Details
`payload.ticker`	`string`	No	—	US-listed company ticker, resolved case-insensitively. Pattern: `^[A-Za-z][A-Za-z0-9.-]{0,14}$`.
`payload.cik`	`string`	No	—	SEC Central Index Key, with or without leading zeroes. Pattern: `^[0-9]{1,10}$`.
`payload.taxonomy`	`"us-gaap" \| "ifrs-full" \| "dei" \| "srt"`	No	`"us-gaap"`	Exact SEC XBRL taxonomy. Defaults to us-gaap. Allowed: `us-gaap`, `ifrs-full`, `dei`, `srt`.
`payload.tag`	`string`	Yes	—	Exact SEC XBRL taxonomy tag. Pattern: `^[A-Za-z][A-Za-z0-9]*$`.
`payload.unit`	`string`	No	—	Optional exact unit filter such as USD, shares, or USD/shares. Minimum length: 1. Maximum length: 80.
`payload.forms`	`array`	No	—	Optional exact form filters, such as 10-K or 10-Q. Minimum items: 1. Maximum items: 20. Items must be unique.
`payload.limit`	`integer`	No	`12`	Maximum facts per returned unit. Defaults to 12. Minimum: 1. Maximum: 100.

Output reference

Normalized SEC XBRL facts for one exact taxonomy concept, grouped by unit.

Name	Type	Required	Default	Details
`result.company`	`object`	Yes	—	Canonical SEC company identity resolved from a ticker or CIK.
`result.company.cik`	`string`	Yes	—	Zero-padded 10-digit SEC CIK.
`result.company.name`	`string`	Yes	—	SEC registrant name.
`result.company.ticker`	`string`	No	—	Matched primary ticker.
`result.company.tickers`	`array`	Yes	—	All tickers reported by the SEC for the registrant.
`result.company.exchange`	`string`	No	—	Matched primary exchange.
`result.company.exchanges`	`array`	Yes	—	All exchanges reported by the SEC for the registrant.
`result.company.sic`	`string`	No	—	Standard Industrial Classification.
`result.company.sic_description`	`string`	No	—	SEC description of the SIC industry.
`result.company.fiscal_year_end`	`string`	No	—	Issuer fiscal year end as MMDD.
`result.taxonomy`	`string`	Yes	—	SEC XBRL taxonomy.
`result.tag`	`string`	Yes	—	Exact XBRL concept tag.
`result.label`	`string`	No	—	Human-readable concept label.
`result.description`	`string`	No	—	SEC taxonomy definition of the concept.
`result.units`	`array`	Yes	—	—
`result.units[].unit`	`string`	Yes	—	Exact SEC unit key, such as USD or shares.
`result.units[].facts`	`array`	Yes	—	—
`result.units[].facts[].value`	`unknown`	Yes	—	Reported XBRL value. Its JSON type depends on the concept and must be checked by the caller.
`result.units[].facts[].start`	`string`	No	—	Start date for duration facts. absent for instants.
`result.units[].facts[].end`	`string`	Yes	—	Fact end date or instant date.
`result.units[].facts[].fiscal_year`	`integer`	No	—	Issuer fiscal year reported by the SEC.
`result.units[].facts[].fiscal_period`	`string`	No	—	Issuer fiscal period, such as FY, Q1, Q2, or Q3.
`result.units[].facts[].form`	`string`	Yes	—	Form containing this fact, such as 10-K or 10-Q.
`result.units[].facts[].filed_at`	`string`	Yes	—	Date the containing filing was submitted.
`result.units[].facts[].accession_number`	`string`	Yes	—	Accession number of the containing filing.
`result.units[].facts[].frame`	`string`	No	—	Optional SEC calendar frame, useful for distinguishing quarter-only facts from other contexts.
`result.units[].facts[].filing_url`	`string`	Yes	—	Authoritative SEC source URL. Format: `uri`.
`result.units[].total_fact_count`	`integer`	Yes	—	Matching facts available before applying the limit.
`result.units[].is_partial`	`boolean`	Yes	—	True when matching facts were omitted by the limit.
`result.source_url`	`string`	Yes	—	Authoritative SEC source URL. Format: `uri`.

Deepline cost

Pricing model: fixed (per call).
Estimated Deepline credits: 0 per pricing unit.
Provider-native pricing may still exist outside Deepline credit billing.

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation