sec_edgar_list_available_concepts
List the US-GAAP tags a company reports to the SEC, ranked by data points. Find valid tag values when a concept is missing, then pass them back to retrieve that concept's series.
Instructions
Lists the US-GAAP tags a company actually reports to the SEC. Call this when sec_edgar_get_concept_series cannot find a concept: the returned 'tag' values can be passed straight back into that tool. Narrow the result with search (case-insensitive substring match on tag and label). Results are ordered by how many data points each tag has, so the company's primary line items come first.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"ticker": "<ticker>"
},
"name": "sec_edgar_list_available_concepts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of tags to return; check has_more in the response | |
| search | No | Substring to match against tag names and labels, e.g. 'revenue' | |
| ticker | Yes | Stock ticker symbol, e.g. AAPL |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cik | Yes | ||
| concepts | Yes | ||
| has_more | Yes | True if more tags matched than were returned; narrow with search | |
| returned | Yes | Number of tags returned in this response | |
| total_matching | Yes | Total number of tags matching the filter |