> ## Documentation Index > Fetch the complete documentation index at: https://deepline.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # SEC EDGAR: Get Company Concept > Retrieving one source-backed reported XBRL financial concept over time. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost. Retrieving one source-backed reported XBRL financial concept over time. Tool ID: `sec_edgar_get_company_concept` ## Run this action Use the TypeScript SDK for a single call. Put `ctx.tools.execute(...)` inside a Play when the call should be durable, scheduled, or run across a CSV. ```ts theme={null} 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 ```bash theme={null} deepline tools execute sec_edgar_get_company_concept --input '{ "tag": "example" }' --json ``` ## Example response The SDK exposes this shape at `result.toolResponse.raw`. Values below are representative. ```json theme={null} { "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 tools get 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. |
Show raw input schema ### Input JSON Schema ```json theme={null} { "type": "object", "properties": { "ticker": { "type": "string", "description": "US-listed company ticker, resolved case-insensitively.", "pattern": "^[A-Za-z][A-Za-z0-9.-]{0,14}$" }, "cik": { "type": "string", "description": "SEC Central Index Key, with or without leading zeroes.", "pattern": "^[0-9]{1,10}$" }, "taxonomy": { "type": "string", "description": "Exact SEC XBRL taxonomy. Defaults to us-gaap.", "default": "us-gaap", "enum": [ "us-gaap", "ifrs-full", "dei", "srt" ] }, "tag": { "type": "string", "description": "Exact SEC XBRL taxonomy tag.", "pattern": "^[A-Za-z][A-Za-z0-9]*$" }, "unit": { "type": "string", "description": "Optional exact unit filter such as USD, shares, or USD/shares.", "minLength": 1, "maxLength": 80 }, "forms": { "type": "array", "description": "Optional exact form filters, such as 10-K or 10-Q.", "minItems": 1, "maxItems": 20, "uniqueItems": true, "items": { "type": "string", "minLength": 1, "maxLength": 20 } }, "limit": { "type": "integer", "description": "Maximum facts per returned unit. Defaults to 12.", "default": 12, "minimum": 1, "maximum": 100 } }, "required": [ "tag" ], "additionalProperties": false } ```
## 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`. |
Show raw output schema ### Output JSON Schema ```json theme={null} { "type": "object", "description": "Normalized SEC XBRL facts for one exact taxonomy concept, grouped by unit.", "properties": { "company": { "type": "object", "description": "Canonical SEC company identity resolved from a ticker or CIK.", "properties": { "cik": { "type": "string", "description": "Zero-padded 10-digit SEC CIK." }, "name": { "type": "string", "description": "SEC registrant name." }, "ticker": { "type": "string", "description": "Matched primary ticker." }, "tickers": { "type": "array", "description": "All tickers reported by the SEC for the registrant.", "items": { "type": "string" } }, "exchange": { "type": "string", "description": "Matched primary exchange." }, "exchanges": { "type": "array", "description": "All exchanges reported by the SEC for the registrant.", "items": { "type": "string" } }, "sic": { "type": "string", "description": "Standard Industrial Classification." }, "sic_description": { "type": "string", "description": "SEC description of the SIC industry." }, "fiscal_year_end": { "type": "string", "description": "Issuer fiscal year end as MMDD." } }, "required": [ "cik", "name", "tickers", "exchanges" ], "additionalProperties": false }, "taxonomy": { "type": "string", "description": "SEC XBRL taxonomy." }, "tag": { "type": "string", "description": "Exact XBRL concept tag." }, "label": { "type": "string", "description": "Human-readable concept label." }, "description": { "type": "string", "description": "SEC taxonomy definition of the concept." }, "units": { "type": "array", "items": { "type": "object", "properties": { "unit": { "type": "string", "description": "Exact SEC unit key, such as USD or shares." }, "facts": { "type": "array", "items": { "type": "object", "properties": { "value": { "description": "Reported XBRL value. Its JSON type depends on the concept and must be checked by the caller." }, "start": { "type": "string", "description": "Start date for duration facts; absent for instants." }, "end": { "type": "string", "description": "Fact end date or instant date." }, "fiscal_year": { "type": "integer", "description": "Issuer fiscal year reported by the SEC." }, "fiscal_period": { "type": "string", "description": "Issuer fiscal period, such as FY, Q1, Q2, or Q3." }, "form": { "type": "string", "description": "Form containing this fact, such as 10-K or 10-Q." }, "filed_at": { "type": "string", "description": "Date the containing filing was submitted." }, "accession_number": { "type": "string", "description": "Accession number of the containing filing." }, "frame": { "type": "string", "description": "Optional SEC calendar frame, useful for distinguishing quarter-only facts from other contexts." }, "filing_url": { "type": "string", "description": "Authoritative SEC source URL.", "format": "uri" } }, "required": [ "value", "end", "form", "filed_at", "accession_number", "filing_url" ], "additionalProperties": false } }, "total_fact_count": { "type": "integer", "description": "Matching facts available before applying the limit." }, "is_partial": { "type": "boolean", "description": "True when matching facts were omitted by the limit." } }, "required": [ "unit", "facts", "total_fact_count", "is_partial" ], "additionalProperties": false } }, "source_url": { "type": "string", "description": "Authoritative SEC source URL.", "format": "uri" } }, "required": [ "company", "taxonomy", "tag", "units", "source_url" ], "additionalProperties": false } ```
## Deepline cost * Pricing model: `fixed` (per call). * Estimated Deepline credits: `0` per pricing unit. * Provider-native pricing may still exist outside Deepline credit billing. ## Related documentation * [SDK V2 quickstart](/docs/sdk-v2/quickstart) * [SDK reference](/docs/sdk-v2/sdk-reference) * [Run tools across a CSV](/docs/sdk-v2/batch-csv)