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

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

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

> [!NOTE]
>
> 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.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
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={"languages":{"custom":["/languages/deepline-prompt.json"]}}
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.

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "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. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "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
  }
  ```
</details>

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

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "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
  }
  ```
</details>

## 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](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.